По вопросам работы с Seller API обращайтесь в поддержку через личный кабинет.
Информационная платформа и сообщество разработчиков Ozon for Dev


Ozon Seller API — программный интерфейс для работы с маркетплейсом Ozon. Он даёт возможность обмениваться информацией между системой продавца и Ozon.
Методы Seller API позволяют изменять данные магазина, например, остатки товаров или их стоимость, и получать данные, такие как информация о возвратах или список складов.
Работа с API состоит из отправки запроса и получения ответа. Для этого можно использовать вкладку Консоль, которая находится сверху описания методов, Postman или настроить интеграцию с системами учёта, например, 1С, ERP или МойСклад.
При интеграции системы учёта продавца с Seller API обновлять и получать данные можно в автоматическом режиме. Это поможет поддерживать актуальной информацию о ценах и остатках товаров, обрабатывать больше заказов за меньшее время и исключить ошибки из-за обновления данных вручную.
Например, вам нужно обновить информацию об остатках или ценах 100 товаров. Чтобы сделать это через личный кабинет, необходимо вручную изменить данные на карточке каждого товара.
Метод /v2/products/stocks позволяет одним запросом обновить информацию об остатках сразу 100 товаров, а метод /v1/product/import/prices — их стоимость.
Перед началом работы с Ozon Seller API:
Для работы с Seller API необходим API-ключ. Подробнее в разделе Авторизация.
Seller API работает по UTC. Учитывайте это, когда отправляете запросы и получаете ответы с датами и временем.
Процесс работы с Seller API можно разделить на блоки:
Чтобы получить API-ключ:
Вы можете создать несколько API-ключей. Например, если у вас несколько пользователей с разными уровнями доступа.
Если вы хотите изменить разрешённые сети для ключа, в списке API-ключей выберите нужный и нажмите
.
Внесите изменения и нажмите Обновить.
Рабочая среда — это ваш магазин. Все отправленные запросы, кроме информационных, могут изменять данные в личном кабинете и на сайте Ozon.
Рабочая среда: api-seller.ozon.ru
Созданные товары можно посмотреть по ссылке вида: https://www.ozon.ru/context/detail/id/SKU, где вместо «SKU» нужно указать значение для созданного товара.
GET / HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: <Client-Id>
Api-Key: <Api-Key>
Content-Type: application/json
Для проверки корректности формата запроса используйте вкладку Консоль над описанием метода или Postman.
/v1/description-category/tree — получите список категорий и типов в виде дерева и используйте значение последнего уровня выбранной категории.
/v1/description-category/attribute — получите характеристики для выбранных категории и типа.
/v1/description-category/attribute/values — получите список значений для выбранной характеристики.
После сравнения своих атрибутов и характеристик с атрибутной моделью Ozon можете приступить к загрузке товаров:
/v3/product/import — загрузите товары и услуги. Этот метод также позволяет обновить уже загруженные товары. В запросе устанавливается первичная цена и загружаются изображения товара. Для услуг необходимо указать геоограничения. Список геоограничений можно получить методом /v2/products/get-geo-restrictions-catalog-by-filter.
В одном запросе можно передать до 100 товаров. Изображения загружаются прямой ссылкой на облачное хранилище, где они хранятся.
В результате работы метода вы получите task_id — номер задания на загрузку товаров.
/v1/product/import/info — проверьте task_id, который вы получили при
загрузке товаров. Метод вернёт информацию, успешно ли загрузились товары или при импорте была ошибка.
Если ответ содержит статус, что товар на модерации, подождите её результатов и проверьте статус товара повторно. Обычно модерация занимает меньше одного дня.
/v1/product/upload_digital_codes — загрузите коды активации, если вы
продаёте цифровые товары или услуги. Код активации привязывается к карточке цифрового товара. После продажи цифрового
товара вы сможете посмотреть привязку кода к отправлению в ответе
метода /v2/posting/fbo/get. В результате работы метода вы получите task_id —
номер задания на загрузку кода активации.
/v1/product/upload_digital_codes/info — проверьте task_id, который
вы получили при загрузке кодов активации. Метод вернёт информацию, успешно ли загрузились коды или возникла ошибка.
/v2/product/list — получите список созданных товаров после загрузки товаров.
Метод позволяет использовать фильтры, чтобы разбить товары на группы по статусу видимости или отслеживать изменение их статуса с помощью идентификатора товара.
Метод возвращает пару значений offer_id и product_id — они нужны практически во всех запросах для идентификации
товара, с которым будет производиться действие. Если вы загружали товары через шаблон, используйте этот метод для
получения offer_id и product_id, чтобы в дальнейшем работать по API с товарами.
Чтобы добавить изображения товара или заменить существующие, используйте:
Чтобы обновить информацию о товаре и его характеристики, используйте /v3/product/import.
Если нужно обновить только характеристики товара, используйте /v1/product/attributes/update.
/v2/product/info — получите информацию о товаре, например штрихкод, цену главного предложения, идентификатор категории, комиссию или ошибки модерации.
/v2/product/info/list — с помощью фильтров /v2/product/list получите список пакетно по всем товарам сразу или по категориям.
/v3/products/info/attributes — получите описание характеристик товара. Метод позволяет добавить дополнительную информацию к товару, чтобы карточка товара была более полной.
/v1/product/info/description — получите описание товара, чтобы использовать его для создания схожего товара.
/v1/product/info/discounted — получите информацию об уценке и основном товаре по SKU уценённого товара.
/v2/products/delete — удалите товар, если он загрузился с ошибкой и попал в архив без SKU. Товары, которые успешно прошли модерацию и получили SKU, удалить из архива нельзя.
/v1/product/archive — перенесите товар в архив. Перед архивированием товара обнулите его остатки.
/v1/product/unarchive — верните товар из архива.
Товар попадёт в продажу, только когда вы установите его остаток.
type — значение value из ответа /v1/product/certificate/types;status — значение code из ответа v1/product/certificate/status/list.Чтобы привязать сертификат к товару:
Чтобы посмотреть список товаров, привязанных к сертификату, воспользуйтесь методом v1/product/certificate/products/list.
Если нужно получить список товаров с определённым статусом, в параметре status передайте значение code из ответа v1/product/certificate/product_status/list.
Чтобы отвязать товар от сертификата, используйте /v1/product/certificate/products/unbind.
Чтобы получить атрибуты для управления сертификатом:
Для создания сертификата используйте /v1/product/certificate/create, передав в запросе:
type_code — значение value из ответа /v1/product/certificate/types;accordance_type_code — значение code из ответа /v2/product/certificate/accordance-types/list.Чтобы удалить сертификат, используйте /v1/product/certificate/delete.
После загрузки товаров для схем FBS и rFBS можно перейти к обновлению остатков. Для схемы FBO остатки обновляются автоматически по факту продажи.
Для обновления остатков используйте методы:
Для получения информации о количестве остатков для FBO используйте /v3/product/info/stocks.
Для получения информации о количестве остатков для FBS и rFBS используйте v1/product/info/stocks-by-warehouse/fbs.
Чтобы обновить цены по товарам и не менять карточку товара, используйте /v1/product/import/prices.
Метод позволяет обновить цену:
Для получения информации о ценах, комиссиях и скидках на товары используйте /v4/product/info/prices.
Если товары заказывают юридические лица, оплата может поступать не сразу — система зарезервирует товары.
Чтобы проверить остатки, используйте методы /v3/posting/fbs/get, /v3/posting/fbs/list или /v3/posting/fbs/unfulfilled/list.
Если в ответе is_legal = true, значит среди остатков есть зарезервированные товары.
Вы можете обновить остатки так, чтобы новое количество товаров было больше свободного остатка и зарезервированного товара в сумме.
Система спишет старый остаток и рассчитает новый.
Чтобы проверить резервирование товара, используйте метод /v3/product/info/stocks.
Для продвижения товаров участвуйте в акциях, которые Ozon проводит для покупателей.
Получите список доступных акций: /v1/actions.
Получите список товаров, которые могут участвовать в акции: /v1/actions/candidates.
Добавьте товары в акцию: /v1/actions/products/activate.
Получите список товаров, которые участвуют в акции: /v1/actions/products.
Удалите товары из акции: /v1/actions/products/deactivate.
Покупатели могут попросить у вас скидку на товар.
Чтобы получить список товаров, которые покупатели хотят купить со скидкой, воспользуйтесь методом
/v1/actions/discounts-task/list.
Заявки в статусах NEW (новые) или SEEN (просмотренные) вы можете:
Получите список доступных акций Hot Sale: /v1/actions/hotsales/list.
Получите список товаров, которые могут участвовать или уже участвуют в акции Hot Sale: /v1/actions/hotsales/products.
Добавьте товары в акцию Hot Sale: /v1/actions/hotsales/activate.
Удалите товары из акции Hot Sale: /v1/actions/hotsales/deactivate.
Стратегии ценообразования — инструмент для автоматического изменения стоимости товаров в соответствии с ценами на аналогичные товары в других интернет-магазинах и маркетплейсах.
Подробнее о стратегиях в Базе знаний для продавцов из России
Подробнее о стратегиях в Справке для продавцов Ozon Global
Чтобы настроить стратегии ценообразования:
Получите список конкурентов: /v1/pricing-strategy/competitors/list.
Получите список стратегий ценообразования: /v1/pricing-strategy/list.
Создайте свою стратегию: /v1/pricing-strategy/create и установите коэффициенты, чтобы изменять стоимость товара по сравнению с другими площадками в большую и меньшую сторону. Чтобы получить информацию о стратегии, используйте метод /v1/pricing-strategy/info.
Добавьте товары в стратегию: /v1/pricing-strategy/products/add.
Вы можете добавить товары:
Чтобы получить список товаров, которые привязаны к стратегии, используйте метод /v1/pricing-strategy/products/list, а для удаления товаров из стратегии — /v1/pricing-strategy/products/delete.
Включите или отключите стратегию: /v1/pricing-strategy/status.
Чтобы изменить список выбранных конкурентов и название стратегии, используйте метод /v1/pricing-strategy/update.
Для удаления стратегии используйте метод /v1/pricing-strategy/delete.
/v1/delivery-method/list — получите список методов склада.
/v1/warehouse/list — получите список складов.
Обработайте заказы в зависимости от схемы работы:
Если вы продаёте товары из-за рубежа, обрабатывайте заказы по одной из схем:
Подробнее о заказах с весовыми товарами при работе по схеме rFBS
Перед созданием заявки на поставку проверьте загруженность складов Ozon: /v1/supplier/available_warehouses.
Для получения списка отправлений, финансовой и аналитической информации используйте /v2/posting/fbo/list. Также метод возвращает информацию о проданных кодах активации с привязкой к номеру отправления.
Чтобы получить информацию по отправлению, используйте /v2/posting/fbo/get.
Для поставки на фулфилмент Ozon нужна заявка. В ней указано, какие товары и в каком количестве вы привезёте.
Для проезда на фулфилмент выберите интервал поставки и оформите пропуск для водителя и автомобиля. Для этого:
Перед началом работы с отправлениями получите список необработанных отправлений: /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
Получите идентификаторы экземпляров exemplar_id методом /v5/fbs/posting/product/exemplar/create-or-get.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
Перед сборкой убедитесь, что отправление соответствует установленным в пункте приёма ограничениям. Получите ограничения пункта приёма по номеру отправления: /v1/posting/fbs/restrictions.
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Для каждого отправления распечатайте наклейку для идентификации в системе Ozon: /v2/posting/fbs/package-label.
Подтвердите отгрузку и запустите формирование транспортной накладной: /v2/posting/fbs/act/create. В ответе метода вы получите идентификатор задания на формирование транспортной накладной и штрихкода для отгрузки.
Запросите информацию о созданной поставке с помощью метода /v1/carriage/get.
Массив available_actions содержит информацию о доступных действиях с поставкой и необходимости создать пропуск для проезда на склад Ozon.
Чтобы создать пропуск, используйте метод /v1/carriage/pass/create.
Чтобы после поставки товаров вы могли забрать возвраты на этой же машине, передайте значение with_returns = true.
Для каждой поставки нужен новый пропуск.
Для редактирования или удаления пропуска используйте методы /v1/carriage/pass/update и /v1/carriage/pass/delete.
Список всех пропусков можно получить с помощью метода /v1/pass/list.
Получите список перевозок, по которым нужно распечатать штрихкод для отгрузки и транспортную накладную: /v1/posting/carriage-available/list.
Проверьте, что отгрузка создана: /v2/posting/fbs/act/check-status.
Получите штрихкод для отгрузки: /v2/posting/fbs/act/get-barcode.
Проверьте статус формирования накладной: /v2/posting/fbs/digital/act/check-status.
Когда статус документа перейдёт в FORMED, получите файлы:
После этого можете отвезти отправления и документы в пункт приёма.
Если отправление передано в доставку, но не просканировано в сортировочном центре, вы можете открыть
спор: /v2/posting/fbs/arbitration. Открытый спор переведёт
отправление в статус arbitration.
Если спор по отправлению откроет покупатель, статус отправления изменится на client_arbitration.
Чтобы отследить изменение статуса, когда отправление найдено, используйте /v3/posting/fbs/list с нужными фильтрами.
Для передачи спорных заказов к отгрузке
используйте /v2/posting/fbs/awaiting-delivery. Статус
отправления изменится на awaiting_deliver.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Перед началом работы с отправлениями получите список необработанных отправлений: /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
Перед сборкой убедитесь, что отправление соответствует установленным в пункте приёма ограничениям. Получите ограничения пункта приёма по номеру отправления: /v1/posting/fbs/restrictions.
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Подтвердите отгрузку: /v2/posting/fbs/act/create. В ответе метода вы получите идентификатор задания на формирование транспортной накладной и штрихкода для отгрузки.
Получите список перевозок, по которым нужно распечатать штрихкод для отгрузки и транспортную накладную: /v1/posting/carriage-available/list.
Проверьте статус формирования накладной: /v2/posting/fbs/digital/act/check-status.
Когда статус документа перейдёт в FORMED, получите файлы:
Для каждого отправления распечатайте наклейку для идентификации в системе Ozon: /v2/posting/fbs/package-label.
После того как вы упаковали все отправления по требованиям из раздела Доверительная приёмка грузового места в Базе знаний продавца, получите этикетки на каждое грузовое место: /v2/posting/fbs/act/get-container-labels.
После этого можете передать грузовое место в пункт приёма или курьеру Ozon.
Если отправление передано в доставку, но не просканировано в сортировочном центре, вы можете открыть
спор: /v2/posting/fbs/arbitration. Открытый спор переведёт
отправление в статус arbitration.
Если спор по отправлению откроет покупатель, статус отправления изменится на client_arbitration.
Чтобы отследить изменение статуса, когда отправление найдено, используйте /v3/posting/fbs/list с нужными фильтрами.
Для передачи спорных заказов к отгрузке
используйте /v2/posting/fbs/awaiting-delivery. Статус
отправления изменится на awaiting_deliver.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана.
Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Если в параметре available_actions указано set_cutoff, уточните дату отгрузки отправления с помощью метода
/v1/posting/cutoff/set. Сделайте это не позднее даты, которая указана в
параметре shipment_date в методах: /v3/posting/fbs/unfulfilled/list,
/v3/posting/fbs/list или /v3/posting/fbs/get.
После даты shipment_date уточнить дату отгрузки и собрать отправление не получится.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Когда сборка заказа завершена, свяжитесь с покупателем для согласования даты доставки. Если покупателю не подходит дата, вы можете перенести её: /v1/posting/fbs/timeslot/set. Посмотрите доступные даты для переноса доставки и количество доступных переносов: /v1/posting/fbs/timeslot/change-restrictions.
Передайте отправление курьеру:
Когда курьер забрал отправление, измените статус отправления на «Доставляется»: /v2/fbs/posting/delivering.
Одновременно с этим, если у отправления есть трек-номер, передайте его: /v2/fbs/posting/tracking-number/set.
Когда курьер едет к покупателю, поменяйте статус отправления на «Последняя миля»: /v2/fbs/posting/last-mile.
Когда курьер передал отправление покупателю, поменяйте статус на «Доставлено»: /v2/fbs/posting/delivered.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана.
Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list.
Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами.
Можно также получить данные аналитики, если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.
Передайте отправление курьеру.
Дальше подстатусы будут изменяться автоматически:
on_way_to_city — курьер забрал заказ. on_way_to_pickup_point — курьер везёт заказ в пункт выдачи.in_pickup_point — отправление приняли в пункте выдачи.delivered — покупатель забрал заказ из пункта выдачи.Чтобы проверить статус отправления, используйте метод /v3/posting/fbs/list.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
Если товар в отправлении упакован в несколько коробок, передайте их количество: /v3/posting/multiboxqty/set. Если не сделать этого до сборки, вам придётся объединить все коробки в одну.
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_registration.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Когда перевозчик обработает отправление, его статус изменится с awaiting_registration на awaiting_delivery. После
этого отправлению будет присвоен трек-номер.
Для каждого отправления распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.
Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.
Если вы продаёте из Турции и вам нужны декларации Elektronik Ticaret Gümrük Beyannamesi (ETGB) для возврата налоговой пошлины, получите декларации: /v1/posting/global/etgb.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана.
Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Если в параметре available_actions указано set_cutoff, уточните дату отгрузки отправления с помощью метода
/v1/posting/cutoff/set. Сделайте это не позднее даты, которая указана в
параметре shipment_date в методах: /v3/posting/fbs/unfulfilled/list,
/v3/posting/fbs/list или /v3/posting/fbs/get.
После даты shipment_date уточнить дату отгрузки и собрать отправление не получится.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Если в настройках метода доставки вы задали временной промежуток для передачи отправления в службу доставки, измените
статус отправления на sent_by_seller — «Отправлено
продавцом»: /v2/fbs/posting/sent-by-seller.
После передачи отправления в службу доставки измените статус отправления на delivering —
«Доставляется»: /v2/fbs/posting/delivering.
Одновременно с этим, если у отправления есть трек-номер, передайте его: /v2/fbs/posting/tracking-number/set.
Когда курьер едет к покупателю, поменяйте статус отправления на «Последняя миля»: /v2/fbs/posting/last-mile.
Когда курьер передал отправление покупателю, поменяйте статус на «Доставлено»: /v2/fbs/posting/delivered.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана.
Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Для каждого отправления распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.
Если в настройках метода доставки вы задали временной промежуток для передачи отправления в службу доставки, измените
статус отправления на sent_by_seller — «Отправлено
продавцом»: /v2/fbs/posting/sent-by-seller.
Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Перед тем, как перевести заказ с весовыми товарами в статус «Ожидает отгрузки» — awaiting_delivery, передайте
уточнённые данные о весе весовых товаров. Для этого после взвешивания во время сборки передайте информацию о весе
каждого экземпляра каждого весового SKU через
метод /v2/posting/fbs/product/change.
Товар необходимо взвешивать, если при создании товара вы указали, что товар весовой, и добавили к нему атрибуты 20577, 8933 и 8934.
После передачи корректного веса для всех экземпляров всех весовых товаров вы сможете перевести отправление в статус
«Ожидает отгрузки» — awaiting_delivery.
API вернёт ошибку 400, если вы:
/v3/returns/company/fbo — получите информацию о возвращённых товарах, которые продаются по схеме FBO.
/v3/returns/company/fbs — получите информацию о возвращённых товарах, которые продаются по схеме FBS.
Убедитесь, что вы можете получать возвратные отгрузки по штрихкоду: /v1/return/giveout/is-enabled. Если у вас есть доступ, в параметре enabled будет указано значение true.
Чтобы получить возвратную отгрузку, запросите штрихкод:
Получите информацию и список возвратных отгрузок:
Вы можете забрать возвраты отдельно от поставки товаров. Если для проезда на склад Ozon нужен пропуск, создайте его с помощью метода /v1/return/pass/create. Для каждого проезда за возвратами нужен новый пропуск.
Для редактирования и удаления пропуска используйте методы /v1/return/pass/update и /v1/return/pass/delete.
Список всех пропусков можно получить с помощью метода /v1/pass/list.
Получите заявки и информацию о них:
Примите решение по заявке и возврату денег:
Запросите у покупателя товар для проверки и подтвердите получение товара с помощью метода /v2/returns/rfbs/receive-return.
Для получения списка чатов используйте /v2/chat/list. В ответе будут идентификаторы текущих чатов и последних сообщений.
Для отправки сообщений по идентификатору чата используйте методы:
/v1/chat/send/message — для отправки текстового сообщения.
/v1/chat/send/file — для отправки файла или изображения.
Для получения истории чата по идентификатору чата или сообщения используйте метод /v2/chat/history. Направление сортировки по умолчанию — от новых сообщений к старым.
Если указать идентификатор сообщения, то история начнётся с этого сообщения.
Чтобы создать новый чат с покупателем по номеру отправления, воспользуйтесь /v1/chat/start.
Чтобы отметить сообщение и все сообщения до него прочитанными, используйте /v2/chat/read.
При запросе любого из отчётов сначала возвращается код на создание документа. Отправьте его в запросе метода /v1/report/info — в ответе вернётся файл отчёта и дополнительная информация.
Чтобы получить список сформированных ранее отчётов, используйте /v1/report/list.
Методы для получения отчётов:
/v1/report/products/create — отчёт с данными о товарах, например Ozon ID, описанием товара, цены, комиссии или габаритов упаковки.
/v3/finance/transaction/list — отчёт по транзакциям, доступный в личном кабинете продавца.
/v4/product/info/price — отчёт по ценам.
/v1/report/warehouse/stock — отчёт по остаткам на складе.
/v1/report/returns/create — отчёт о возвращённых товарах для FBS и rFBS. Отчёт содержит товары, принятые от покупателя, готовые к получению или переданные продавцу.
/v1/report/postings/create — отчёт об отправлениях.
/v1/finance/cash-flow-statement/list — финансовый отчёт.
/v1/report/discounted/create — отчёт об уценённых товарах.
/v1/analytics/data — получите данные аналитики.
Если укажете период и метрики, которые нужно рассчитать, в ответе будет аналитиĸа, сгруппированная по параметру
dimensions.
/v2/analytics/stock_on_warehouses — получите отчёт по остаткам и товарам в перемещении на складах Ozon.
Чтобы получить отчёт по оборачиваемости FBO, запросите его в личном кабинете.
/v3/finance/transaction/list — получите подробную информацию по транзакциям для отправления.
/v3/finance/transaction/totals — получите детальную информацию по итоговым суммам транзакций за указанный период.
/v1/rating/summary — получите текущие значения рейтингов продавца.
/v1/rating/history — получите информацию о рейтингах продавца за период и количество штрафных баллов, начисленных в Premium-программе.
| Метод | Что изменилось |
|---|---|
| /v1/posting/fbs/pick-up-code/verify | Добавили метод для проверки кода курьера. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Добавили параметр result.postings.pickup_code_verified_at в ответы методов. |
| /v3/posting/fbs/get | Добавили параметр result.pickup_code_verified_at в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Добавили параметр prices.min_price_for_auto_actions_enabled в запрос метода. |
| /v1/product/action/timer/update | Добавили бета-метод для обновления таймера актуальности минимальной цены. |
| /v1/product/action/timer/status | Добавили бета-метод для получения статуса установленного таймера. |
| Метод | Что изменилось |
|---|---|
| /v1/returns/list | Обновили описание параметров filter и filter.posting_numbers в запросе метода. |
| /v2/product/pictures/info | Перенесли метод из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/digital/act/document-sign | Метод устарел, удалили его из документации. |
| Метод | Что изменилось |
|---|---|
| /v1/supply-order/bundle | Добавили описание метода, изменили описания параметров bundle_ids, last_id и limit в запросе метода. |
| /v1/warehouse/fbo/list | Изменили название и описание метода, изменили описание параметра search в запросе метода. |
| /v1/draft/create/info | Обновили описание параметров clusters.warehouses.bundle_ids.bundle_id и clusters.warehouses.restricted_bundle_id в ответе метода. |
| /v1/cluster/list | Обновили описание параметра cluster_type в запросе метода. |
| /v1/warehouse/fbo/list | Обновили описание параметра filter_by_supply_type в запросе метода. |
| /v1/question/answer/create /v1/question/answer/delete /v1/question/answer/list /v1/question/change-status /v1/question/count /v1/question/info /v1/question/list /v1/question/top-sku |
Добавили бета-методы для работы с вопросами и ответами. |
| Метод | Что изменилось |
|---|---|
| /v1/review/comment/create /v1/review/comment/delete /v1/review/comment/list /v1/review/change-status /v1/review/count /v1/review/info /v1/review/list |
Добавили бета-методы для работы с отзывами. |
| /v1/carriage/create | Добавили бета-метод для создания отгрузки. |
| /v1/carriage/approve | Добавили бета-метод для подтверждения отгрузки. |
| /v1/carriage/delivery/list | Добавили бета-метод для получения списка методов доставки и отгрузок. |
| /v1/carriage/get | Добавили параметры result.is_waybill_enabled и result.is_econom в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/delivery-method/list | Добавили параметр result.sla_cut_in в ответ метода. |
| /v1/supply-order/get | Метод устарел, удалили его из документации. Используйте /v2/supply-order/get. |
| /v1/supply-order/list | Метод устарел, удалили его из документации. Используйте /v2/supply-order/list. |
| /v1/supply-order/items | Метод устарел, удалили его из документации. Используйте /v1/supply-order/bundle. |
| /v4/product/info/prices | Метод устаревает и будет отключён 17 февраля 2025 года. Переключитесь на новую версию /v5/product/info/prices. |
| /v3/product/info/list | Добавили параметр items.is_super в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Добавили параметр prices.vat в запрос метода. |
| /v1/product/import-by-sku /v3/product/import |
Обновили описание параметра items.vat в запросе методов. |
| Метод | Что изменилось |
|---|---|
| /v2/report/returns/create /v1/posting/unpaid-legal/product/list |
Перенесли методы из бета-раздела в основной. |
| /v1/report/returns/create | Метод устаревает и будет отключён 15 февраля 2025 года. Переключитесь на новую версию /v2/report/returns/create. |
| /v3/returns/company/fbo /v3/returns/company/fbs |
Обновили дату отключения методов. |
| Метод | Что изменилось |
|---|---|
| /v1/carriage/set-postings | Добавили бета-метод для изменения состава отгрузки. |
| /v1/carriage/cancel | Добавили бета-метод для удаления отгрузки. |
| Метод | Что изменилось |
|---|---|
| /v3/product/info/list | Добавили бета-метод для получения списка товаров по идентификаторам. |
| /v2/product/info /v2/product/info/list |
Методы устаревают и будут отключены 17 февраля 2025 года. Переключитесь на новую версию /v3/product/info/list. |
| /v2/posting/fbs/act/list | Пометили обязательными параметры filter.date_from и filter.date_to в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/cargoes/create /v1/cargoes/create/info /v1/cargoes-label/create /v1/cargoes-label/get /v1/cargoes-label/file/{file_guid} |
Добавили бета-методы для работы с грузоместами. |
| — | В разделе Порядок работы с методами → Управляйте заказами FBO, FBS и rFBS → Схема FBO добавили информацию об управлении грузоместами в заявке на поставку. |
| Метод | Что изменилось |
|---|---|
| /v2/product/pictures/info | Добавили бета-метод для получения изображений товаров. |
| /v1/product/pictures/info | Метод устаревает и будет отключён 11 февраля 2025 года. Переключитесь на новую версию /v2/product/pictures/info. |
| Метод | Что изменилось |
|---|---|
| /v1/returns/company/fbs/info | В ответе метода: • Добавили параметры drop_off_points.box_count и drop_off_points.utc_offset. • Удалили параметр company_id. |
| /v2/product/list | Удалили статус BANNED из запроса метода, при его использовании будет применено поле по умолчанию. Метод устаревает и будет отключён 9 февраля 2025 года. Переключитесь на новую версию /v3/product/list. |
| /v3/finance/transaction/list | Дополнили описание метода: используйте метод с последовательной отправкой запросов. Обновили описание параметров result.page_count и result.row_count в ответе метода. |
| /v3/product/info/attributes | Метод устаревает и будет отключён 9 февраля 2025 года. Переключитесь на новую версию /v4/product/info/attributes. |
| /v1/returns/list | Добавили параметр returns.product.quantity в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v2/product/certification/list | Добавили бета-метод для получения списка сертифицируемых категорий. |
| Метод | Что изменилось |
|---|---|
| /v4/product/info/stocks | Добавили бета-метод для получения информации о количестве товара. |
| /v3/product/info/stocks | Метод устаревает и будет отключён 31 января 2025 года. Переключитесь на новую версию /v4/product/info/stocks. |
| Метод | Что изменилось |
|---|---|
| /v2/finance/realization | Добавили параметры result.rows.return_commission.bank_coinvestment, result.rows.delivery_commission.pick_up_point_coinvestment и result.rows.return_commission.pick_up_point_coinvestment в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Обновили описание параметров result.postings.analytics_data.city и result.postings.analytics_data.region в ответе методов. |
| /v3/posting/fbs/get | Обновили описание параметров result.analytics_data.city и result.analytics_data.region в ответе метода. |
| /v2/posting/fbo/list /v2/posting/fbo/get |
Параметры result.analytics_data.city и result.analytics_data.region в ответе методов устаревают и будут всегда возвращать пустое значение. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/turnover/stocks | Перенесли метод из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v2/report/returns/create | Добавили бета-метод для получения отчёта о возвратах FBO и FBS. |
| /v1/report/info | Добавили статус SELLER_RETURNS_V2 в параметр report_type. |
| /v1/posting/fbs/split | Перенесли метод из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/unpaid-legal/product/list | Добавили бета-метод для получения списка неоплаченных товаров, заказанных юридическими лицами. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import-by-sku | Обновили название и описание метода, обновили описание параметра items в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/manage/stocks | Добавили бета-метод для управления остатками на складах. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Обновили описание метода и описание параметра prices в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list /v3/posting/fbs/get |
Добавили параметр result.postings.tariffication в ответы методов. |
| /v1/posting/carriage-available/list | Добавили параметры result.recommended_time_local и result.recommended_time_utc_offset_in_minutes в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/report/list | Добавили статусы DOCUMENT_B2B_SALES и MUTUAL_SETTLEMENT в параметр запроса report_type. |
| /v1/report/info | Добавили статусы DOCUMENT_B2B_SALES и MUTUAL_SETTLEMENT в параметр ответа result.reports.report_type. |
| /v3/product/import /v2/products/stocks /v2/posting/fbs/product/cancel |
Обновили описания методов. |
| /v1/finance/cash-flow-statement/list | В описании параметра result.details.services.items.name изменили название операции MarketplaceServiceItemPremiumSubscribtion на MarketplaceServiceItemSubscribtionPremium. |
| — | В разделе Порядок работы с методами добавили информацию об ограничении отправки запросов. |
| Метод | Что изменилось |
|---|---|
| /v1/cluster/list | Добавили бета-метод для получения информации о кластерах. |
| /v1/draft/create | Добавили бета-метод для создания черновика заявки на поставку. |
| /v1/draft/create/info | Добавили бета-метод для получения информации о черновике заявки на поставку. |
| /v1/draft/timeslot/info | Добавили бета-метод для получения доступных таймслотов для черновика заявки на поставку. |
| /v1/draft/supply/create | Добавили бета-метод для создания заявки на поставку по черновику. |
| /v1/supply/create/status | Добавили бета-метод для получения информации о создании заявки на поставку. |
| /v1/warehouse/fbo/list | Добавили бета-метод для получения информации о складах для отгрузки. |
| /v1/finance/mutual-settlement | Добавили бета-метод для получения отчёта о взаиморасчётах. |
| /v1/finance/document-b2b-sales | Добавили бета-метод для получения отчёта о продажах юридическим лицам. |
| — | В разделе Порядок работы с методами → Управляйте заказами FBO, FBS и rFBS → Схема FBO → Создать заявку на поставку добавили информацию о создании заявки на поставку по схеме FBO. |
| /v1/quant/list | Добавили бета-метод для получения списка квантов. |
| /v1/quant/get | Добавили бета-метод для получения информации о кванте и его отправлениях. |
| /v1/quant/ship | Добавили бета-метод для сборки отправлений кванта. |
| /v1/quant/status | Добавили бета-метод для получения статуса кванта. |
| /v1/product/quant/info | Добавили бета-метод для получения информации об эконом-товаре. |
| /v1/product/quant/list | Добавили бета-метод для получения списка эконом-товаров. |
| /v1/warehouse/list | Добавили параметр result.is_economy в ответ метода. |
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Добавили параметры filter.is_quantum в запрос и result.postings.quantum_id в ответ методов. |
| /v2/product/list | Добавили описание метода. У параметра filter.visibility в запросе метода удалили возможные значения IMAGE_ABSENT и MODERATION_BLOCK. |
| — | В разделе Порядок работы с методами → Управляйте заказами FBO, FBS и rFBS → Схема FBS Стандарт → Работа с эконом-товарами добавили информацию о работе с эконом-товарами. |
| /v2/products/stocks | Добавили параметр stocks.quant_size в запрос и result.quant_size в ответ метода. |
| /v1/product/import/prices | Добавили параметр prices.quant_size в запрос метода. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbo /v3/returns/company/fbs |
Методы устаревают и будут отключены 28 декабря 2024 года. Переключитесь на метод /v1/returns/list. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/info | Параметр result.items.errors.optional_description_elements в ответе метода устаревает и будет всегда возвращать пустое значение. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/fbs/split | Добавили бета-метод для разделения заказа на отправления без сборки. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbs | Добавили статусы arrived_for_resale и moving_to_resale в параметр запроса filter.status. |
| Метод | Что изменилось |
|---|---|
| — | Добавили раздел с методами, которые находятся на стадии тестирования. |
| /v1/analytics/turnover/stocks | Добавили бета-метод для получения информации об оборачиваемости товара. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/cutoff/set | Добавили метод для уточнения даты отгрузки отправления, которое доставляет неинтегрированный перевозчик или продавец. |
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Добавили параметр result.postings.available_actions в ответы методов. |
| /v3/posting/fbs/get | Добавили параметр result.available_actions в ответ метода. |
| — | Добавили информацию об указании даты отгрузки отправлений, которые доставляет неинтегрированный перевозчик или продавец по схемам rFBS Стандарт и rFBS Crossborder. |
| /v1/products/geo-restrictions-catalog-by-filter | Удалили метод /v1/products/geo-restrictions-catalog-by-filter из документации. |
| /v3/product/import | Обновили описание параметра items.geo_names в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/returns/list | Добавили метод для получения информации о возвратах FBO и FBS. |
| /v1/rating/summary | Добавили параметр localization_index в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v3/product/import | Обновили раздел «Загрузка видео» в описании метода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Обновили описание параметров result.postings.cancellation.cancellation_type и result.postings.cancellation.cancellation_initiator в ответе метода. |
| /v3/posting/fbs/get | Обновили описание параметров result.cancellation.cancellation_type и result.cancellation.cancellation_initiator в ответе метода. |
| /v1/finance/cash-flow-statement/list | Обновили описание параметра result.details.services.items.name в ответе метода. |
| /v3/finance/transaction/list | Обновили описание параметров filter.operation_type в запросе метода и result.operations.services.name в ответе метода. |
| /v4/posting/fbs/ship | Обновили описание метода. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/fbo/cancel-reason/list | Добавили метод для получения информации о причинах отмены отправлений по схеме FBO. |
| /v1/product/import/stocks /v2/products/stocks |
Обновили описание метода и параметра stocks.stock в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/product/cancel | Обновили описание метода. |
| /v2/posting/fbs/cancel-reason/list | Обновили пример ответа. |
| Метод | Что изменилось |
|---|---|
| /v3/product/import /v3/products/info/attributes |
Параметр image_group_id устарел, удалили его из примеров кода. |
| Метод | Что изменилось |
|---|---|
| /v2/supply-order/get | Обновили описание параметра orders.state в ответе метода. |
| /v2/supply-order/list | Обновили описание параметра filter.states в запросе метода. |
| /v1/supply-order/bundle | Обновили описание параметров bundle_ids и limit в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/supply-order/list /v1/supply-order/get |
Методы устаревают и будут отключены в будущем. Переключитесь на новые версии — /v2/supply-order/list и /v2/supply-order/get. |
| /v1/supply-order/status/counter | Добавили новый метод для получения статуса заявки и количества поставок в этом статусе. |
| /v1/supply-order/timeslot/get /v1/supply-order/timeslot/update /v1/supply-order/timeslot/status |
Добавили новые методы по работе с интервалами поставки. |
| /v1/supply-order/pass/create /v1/supply-order/pass/status |
Добавили новые методы для создания пропуска на фулфилмент и получения статуса данных. |
| /v1/supply-order/bundle | Добавили метод для получения состава поставки или заявки на поставку. |
| — | В разделе Порядок работы с методами → Схема FBO → Получите информацию о заявках на поставку обновили порядок работы с методами по схеме FBO. |
| Метод | Что изменилось |
|---|---|
| /v3/finance/transaction/list | Дополнили описание параметра filter.operation_type в запросе метода и result.operations.services.name в ответе метода. |
| /v2/finance/realization | Добавили параметр result.rows.delivery_commission.bank_coinvestment в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v3/product/import /v3/products/info/attributes |
Добавили параметр items.type_id в запрос метода /v3/product/import и result.type_id в ответ метода /v3/products/info/attributes. Подробнее о переходе на type_id. |
| Метод | Что изменилось |
|---|---|
| /v2/analytics/stock_on_warehouses | Добавили параметр result.rows.idc в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v3/product/import | Добавили параметр new_description_category_id в запрос метода — он используется для смены категории уже созданного товара. |
| Метод | Что изменилось |
|---|---|
| /v1/description-category/attribute/values/search | Добавили метод для поиска по справочным значениям характеристики. |
| Метод | Что изменилось |
|---|---|
| Пуш-уведомления | Описали ошибки при подключении пуш-уведомлений. |
| Метод | Что изменилось |
|---|---|
| /v1/supply-order/list | В запросе и ответе удалили статусы поставки по заявке: DRAFT, SUPPLY_VARIANTS_ARRANGING, HAS_NO_SUPPLY_VARIANTS_ARCHIVE, HAS_NO_SUPPLY_VARIANTS_NEW, SUPPLY_VARIANT_CONFIRMATION, TIMESLOT_BOOKING. |
| /v1/products/geo-restrictions-catalog-by-filter | Метод устаревает и будет отключён 1 октября 2024. |
| Метод | Что изменилось |
|---|---|
| Частые ошибки | Обновили описание ошибки Invalid Api-Key, please contact support для метода /v2/posting/fbs/act/create. |
| Частые ошибки | Удалили метод /v2/posting/fbs/ship из документации. |
| /v3/finance/transaction/list | Добавили вид услуги OperationMarketplaceAgencyFeeAggregator3PLGlobal в параметр result.operations.services.name. |
| /v1/report/info /v1/report/list /v1/report/products/create /v1/report/returns/create /v1/report/postings/create /v1/report/discounted/create /v1/report/warehouse/stock |
Обновили описание параметров code и file в ответах и запросах методов. |
| ## 22 июля 2024 |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/list | Добавили параметр filter.last_changed_status_date в запрос метода. |
| Частые ошибки | Добавили описание ошибки GTD_MUST_BE_SPECIFIED_FOR_PRODUCT_COUNTRY для метода /v4/fbs/posting/product/exemplar/validate и NO_POSTINGS_FOR_BATCH_DOWNLOAD для метода /v2/posting/fbs/package-label. |
| /v2/product/info/list | В параметре product_id изменили описание формата ввода данных. |
| /v2/posting/fbo/list /v2/posting/fbo/get |
Добавили возможные значения параметра result.analytics_data.payment_type_group_name в ответе метода. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/get |
Добавили возможные значения параметра result.postings.analytics_data.payment_type_group_name в ответе метода. Дополнили описание статуса cancelled_from_split_pending. |
| /v3/posting/fbs/get | Обновили описание параметров addresse.phone, courier.phone и customer.phone в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/product/import /v1/product/import-by-sku /v2/product/info/list /v2/product/info /v4/product/info/prices |
Параметр premium_price устарел, удалили его из примеров кода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/get /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Удалили параметр customer.customer_email из ответа методов. |
| Раздел | Что изменилось |
|---|---|
| Порядок работы с методами | Добавили информацию о резервировании товаров. |
| Метод | Что изменилось |
|---|---|
| /v1/invoice/create-or-update | Метод устарел, удалили его из документации. Используйте /v2/invoice/create-or-update. |
| /v1/invoice/get | Метод устарел, удалили его из документации. Используйте /v2/invoice/get. |
| Метод / раздел | Что изменилось |
|---|---|
| /v3/finance/transaction/list | Заменили MarketplaceServiceStorageItem на OperationMarketplaceServiceStorage в параметре ответа operations.services. |
| /v1/product/related-sku/get | Обновили описание метода. |
| /v2/product/info/list | Обновили описание параметра items.id в ответе метода. |
| /v3/returns/company/fbs | Обновили описание параметра returns.moving_to_place_name в ответе метода. |
| /v2/posting/fbo/get /v2/posting/fbo/list /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/get /v3/posting/fbs/list |
Пометили устаревшими параметры postings.financial_data.products.item_services и postings.financial_data.posting_services в ответе методов. |
| Частые ошибки | Добавили описание ошибки Incorrect_density для метода /v3/product/import и Incorrect_carriage_status для /v2/posting/fbs/act/create. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/package-label/create | Добавили новую версию метода для создания задания на формирование этикеток. |
| /v1/posting/fbs/package-label/create | Метод устаревает и будет отключён в будущем. Мы предупредим вас об этом за месяц. Переключитесь на новую версию /v2/posting/fbs/package-label/create. |
| Метод | Что изменилось |
|---|---|
| /v4/posting/fbs/ship | Добавили описание ошибки EXEMPLAR_INFO_NOT_FILLED_COMPLETELY в таблице Частые ошибки. |
| /v3/returns/company/fbs | Обновили описание параметра filter.status в запросе метода и параметра returns.product_id в ответе метода. |
| /v4/posting/fbs/ship/package /v1/product/import/prices |
Обновили описание метода. |
| /v3/product/import | Изменили описание параметра items.description_category_id в примере запроса. |
| /v4/product/info/prices /v3/product/import /v2/product/info/list /v2/product/info /v1/product/import-by-sku |
Отметили устаревшим параметр premium_price в ответах и запросах методов. |
| /v1/description-category/attribute/values /v1/description-category/attribute /v1/description-category/tree |
Добавили примеры запросов и ответов. |
| — | Обновили описание уведомлений TYPE_NEW_POSTING, TYPE_POSTING_CANCELLED, TYPE_STATE_CHANGED, TYPE_CUTOFF_DATE_CHANGED, TYPE_DELIVERY_DATE_CHANGED в разделе Пуш-уведомления. |
| Метод | Что изменилось |
|---|---|
| /v2/product/info | Добавили параметры result.is_archived и result.is_autoarchived в ответ метода. |
| /v2/product/info/list | Добавили параметры result.items.is_archived и result.items.is_autoarchived в ответ метода. |
| /v1/product/unarchive | Метод доступен для работы. Обновили описание параметра product_id в запрос метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/stocks | Обновили описание метода. Метод устаревает и будет отключён в будущем. Переключитесь на новую версию — указали её в описании метода. |
| — | В разделе Частые ошибки для методов /v2/products/stocks и /v1/product/import/stocks добавили описание ошибок Fatal error: You have more than 1 FBS warehouses. Please use API Method POST /v2/products/stocks, product_is_not_created, offer_id_not_found, FLAMMABLE_ONLY_ON_SELF_OR_PROVIDER_DELIVERY и WAREHOUSE_NOT_FOUND. |
| /v1/product/import/stocks /v2/products/stocks |
Обновили описание параметра result.errors.code в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v2/finance/realization | Добавили новую версию метода для получения отчёта о реализации товаров. |
| /v1/invoice/create-or-update | Метод устаревает и будет отключён 31 мая 2024 года. Переключитесь на новую версию /v2/invoice/create-or-update. |
| /v1/invoice/file/upload | Добавили метод для загрузки счёта-фактуры. |
| /v1/invoice/get | Метод устаревает и будет отключён 31 мая 2024 года. Переключитесь на новую версию /v2/invoice/get. |
| Метод | Что изменилось |
|---|---|
| — | В разделе Частые ошибки для методов /v4/fbs/posting/product/exemplar/set и /v5/fbs/posting/product/exemplar/set добавили описание ошибок GTD_IS_REQUIRED_ONLY_FOR_LEGAL_CUSTOMER и EXEMPLAR_ID does not belong to product PRODUCT_ID. |
| Метод | Что изменилось |
|---|---|
| /v3/finance/transaction/list | В ответе метода дополнили описание параметра result.operations.services.name. |
| /v1/pricing-strategy/product/info | Добавили описание метода. |
| /v3/product/import | Дополнили описание метода информацией о загрузке видеообложек. |
| — | В разделе Частые ошибки для метода /v2/products/stocks: • удалили описание ошибки SKU STOCK NOT CHANGED;• добавили описание ошибки NOT_FOUND_ERROR. |
| — | Дополнили раздел Порядок работы с методами → Схема FBS Стандарт информацией о получении exemplar_id методом /v5/fbs/posting/product/exemplar/create-or-get. |
| Метод / раздел | Что изменилось |
|---|---|
| /v1/carriage/get | Обновили описание параметра status в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/pictures/import /v1/product/pictures/info |
В ответе метода для поля result.pictures.state изменили статус failed на pending. |
| Метод / раздел | Что изменилось |
|---|---|
| /v1/carriage/get | Добавили метод для получения информации о перевозке. |
| /v1/carriage/pass/create | Добавили метод для создания пропуска. |
| /v1/carriage/pass/update | Добавили метод для обновления пропуска. |
| /v1/carriage/pass/delete | Добавили метод для удаления пропуска. |
| /v1/return/pass/create | Добавили метод для создания пропуска на вывоз возвратов. |
| /v1/return/pass/update | Добавили метод для обновления пропуска на вывоз возвратов. |
| /v1/return/pass/delete | Добавили метод для удаления пропуска на вывоз возвратов. |
| /v1/pass/list | Добавили метод для получения списка пропусков. |
| /v1/returns/company/fbs/info | Добавили метод для получения информации о возвратах FBS и их количестве. |
| Порядок работы с методами | В разделах Схема FBS Стандарт и Получите возвратные отгрузки по штрихкоду описали новые методы по работе с пропусками. |
| Доставка FBS | Создали новый раздел, перенесли в него старые методы и добавили новый — /v1/carriage/get. |
| Доставка rFBS | Создали новый раздел, перенесли в него старые методы. |
| Метод | Что изменилось |
|---|---|
| /v2/product/info | Параметр minValue в ответе метода устарел, удалили его из документации. |
| /v4/product/info/prices /v2/product/info |
Параметр recommended_price в ответе метода устарел, удалили его из документации. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/list /v3/posting/fbs/get /v3/posting/fbs/unfulfilled/list /v2/posting/fbo/get /v2/posting/fbo/list |
Отметили устаревшим параметр client_price в ответе. |
| Метод | Что изменилось |
|---|---|
| /v2/category/attribute/values | Метод устарел, удалили его из документации. Используйте /v1/description-category/attribute/values. |
| /v2/category/tree | Метод устарел, удалили его из документации. Используйте /v1/description-category/tree. |
| /v3/category/attribute | Метод устарел, удалили его из документации. Используйте /v1/description-category/attribute. |
| /v2/product/import | Метод устарел, удалили его из документации. Используйте /v3/product/import. |
| /v3/posting/fbs/unfulfilled/list | Добавили значение hybryd для параметра ответа tpl_integration_type. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbs | Удалили параметр accepted_from_customer_moment из запроса и ответа метода. |
| Метод | Что изменилось |
|---|---|
| — | В разделе Порядок работы с методами добавили, что для продавцов rFBS Стандарт с 11 марта 2024 года максимальный срок доставки до покупателя — 30 дней. Обновите срок в настройках вашего метода. Если срок будет больше максимального, он поменяется автоматически. |
| Метод | Что изменилось |
|---|---|
| /v2/category/tree /v3/category/attribute /v2/category/attribute/values /v2/product/import |
Методы устаревают и будут отключены 11 марта 2024 года. |
| Метод | Что изменилось |
|---|---|
| /v1/chat/list | Метод устарел, удалили его из документации. Используйте /v2/chat/list. |
| /v1/chat/history /v1/chat/updates |
Методы устарели, удалили их из документации. Используйте /v2/chat/history. |
| Метод | Что изменилось |
|---|---|
| /v4/posting/fbs/ship/package | Дополнили описание метода: по умолчанию статус созданных отправлений awaiting_deliver. |
| /v2/chat/history | Добавили описание метода. |
| /v1/analytics/data | Обновили описание параметра id в ответе метода. |
| /v5/fbs/posting/product/exemplar/create-or-get | Дополнили описание метода: используйте метод для получения exemplar_id. |
| /v5/fbs/posting/product/exemplar/set | Дополнили описание метода информацией об ответе. |
| Метод | Что изменилось |
|---|---|
| /v1/description-category/attribute | Добавили параметр result.category_dependent в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/ship | Метод устарел, удалили его из документации. Используйте /v4/posting/fbs/ship. |
| /v3/posting/fbs/ship/package | Метод устарел, удалили его из документации. Используйте /v4/posting/fbs/ship/package. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbo | Добавили параметр return_id и обновили описание параметра id в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbo | Обновили описания параметров status в запросе метода и status_name в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/description-category/attribute | Добавили два параметра в ответ метода: max_value_count и attribute_complex_id. |
| /v3/product/import | Добавили новую версию метода для загрузки и обновления товаров. |
| /v2/product/info /v2/product/info/list |
Добавили параметр type_id в ответ методов. |
| /v1/description-category/tree /v1/description-category/attribute /v1/description-category/attribute/values |
Изменили параметр category_id на description_category_id в запрос и ответ методов. |
| Метод | Что изменилось |
|---|---|
| /v1/chat/list | Дополнили значение параметра page_size в запросе метода. Метод устаревает и будет отключён в будущем. Переключитесь на новую версию — указали её в описании метода. |
| /v1/chat/history | Обновили значения параметра limit в запросе метода. Метод устаревает и будет отключён в будущем. Переключитесь на новую версию — указали её в описании метода. |
| /v2/chat/list /v2/chat/history |
Дополнили значения параметра limit в запросах методов. |
| /v1/chat/updates | Дополнили значения параметра limit в запросах методов. Метод устаревает и будет отключён в будущем. Переключитесь на альтернативную версию — указали её в описании метода. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbo/list | Дополнили описание метода: если период больше года, вернётся ошибка PERIOD_IS_TOO_LONG. Обновили описание параметра offset в запросе метода. |
| /v3/products/info/attributes | Добавили описание параметра images.default в ответе метода. |
| /v3/posting/fbs/unfulfilled/list | Из описания метода убрали статус delivered и добавили информацию о получении актуальной даты отгрузки. |
| /v1/finance/cash-flow-statement/list | Дополнили значения параметра items.name в ответе метода. |
| /v2/product/info/list | Из описания метода убрали информацию о совпадении полей в параметре items с методом /v2/product/info. |
| /v3/posting/fbs/list /v3/posting/fbs/get |
Обновили описание метода: добавили информацию о получении актуальной даты отгрузки. |
| /v2/posting/fbs/cancel | Обновили описание метода: убрали идентификаторы причин отмены и добавили информацию о проверке статуса отмены для отправления. |
| /v3/finance/transaction/list | Дополнили значения параметра filter.operation_type в запросе метода. |
| /v1/product/import/prices | Обновили описание метода: добавили информацию об ошибке action_price_enabled_min_price_missing. |
| /v3/finance/transaction/totals | Дополнили описание метода: если номера отправлений заполнены неправильно, в ответе вернутся нулевые значения. |
| /v1/product/import/stocks | Обновили описание метода: задать наличие товара возможно только после того, как его статус сменится на price_sent. |
| /v1/report/info | Обновили описание параметра result.file в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/package-label | Обновили описание метода: убрали информацию, что при работе по схеме rFBS не нужно печатать этикетки. |
| Метод | Что изменилось |
|---|---|
| /v5/fbs/posting/product/exemplar/set | Добавили новую версию метода для проверки и сохранения данных экземпляров. |
| /v5/fbs/posting/product/exemplar/create-or-get | Добавили метод для получения данных о созданных экземплярах. |
| /v4/posting/fbs/ship/package | Добавили новую версию метода для частичной сборки отправления. |
| /v4/fbs/posting/product/exemplar/status /v3/posting/fbs/get |
Добавили параметр exemplars.exemplar_id в ответы методов. |
| Метод | Что изменилось |
|---|---|
| /v2/returns/rfbs/list | Добавили метод для получения заявок на возврат rFBS-заказов. |
| /v2/returns/rfbs/get | Добавили метод для получения информации о заявке на возврат rFBS-заказа. |
| /v2/returns/rfbs/reject | Добавили метод для отклонения заявки на возврат rFBS-заказа. |
| /v2/returns/rfbs/compensate | Добавили метод для частичной компенсации стоимости товара в rFBS-заказе. |
| /v2/returns/rfbs/verify | Добавили метод для одобрения заявки на возврат rFBS-заказа. |
| /v2/returns/rfbs/receive-return | Добавили метод для подтверждения, что товар получили для проверки. |
| /v2/returns/rfbs/return-money | Добавили метод для возврата полной стоимости товара в rFBS-заказе. |
| — | В раздел Порядок работы с методами добавили подраздел Управляйте заявками на возврат rFBS-заказов. |
| Метод | Что изменилось |
|---|---|
| /v1/return/giveout/is-enabled | Добавили метод для проверки возможности получения возвратных отгрузок по штрихкоду. |
| /v1/return/giveout/get-pdf /v1/return/giveout/get-png |
Добавили методы для получения штрихкода возвратной отгрузки в формате PDF и PNG. |
| /v1/return/giveout/barcode | Добавили метод для получения штрихкода возвратной отгрузки в текстовом виде. |
| /v1/return/giveout/barcode-reset | Добавили метод для обновления штрихкода возвратной отгрузки. |
| /v1/return/giveout/list | Добавили метод для получения списка возвратных отгрузок. |
| /v1/return/giveout/info | Добавили метод для получения информации о возвратных отгрузках. |
| Метод | Что изменилось |
|---|---|
| v3/posting/fbs/list | Обновили пример запроса. |
| /v3/finance/transaction/list | Дополнили описание параметра result.operations.services.name в ответе метода: добавили услугу drop-off в пункте приёма заказов. |
| /v2/product/info /v2/product/info/list |
Дополнили описание метода: параметр active_product устарел, используйте значение параметра visible. |
| /v1/report/warehouse/stock | Обновили описание метода: он возвращает остатки только для FBS-складов. |
| /v2/products/stocks | Обновили описание метода: задать наличие товара возможно только после того, как его статус сменится на price_sent. |
| Метод | Что изменилось |
|---|---|
| /v1/report/postings/create | Обновили описание параметра delivery_schema в запросе метода и пример запроса. |
| Метод | Что изменилось |
|---|---|
| /v1/product/related-sku/get | Добавили метод для получения связанных SKU. |
| Метод | Что изменилось |
|---|---|
| /v3/product/info/stocks | Обновили пример ответа. Теперь метод возвращает остатки товаров по всем схемам работы — FBO, FBS и Crossborder, даже если вы не работаете по каким-то из них. |
| /v1/report/info | Добавили описания статусов waiting и processing в параметр status их ответа метода. |
| /v3/posting/fbs/ship | Метод устаревает и будет отключён в будущем. Переключитесь на новую версию — указали её в описании метода. |
| Метод | Что изменилось |
|---|---|
| /v1/report/warehouse/stock | Добавили метод для формирования отчёта об остатках на складе. |
| /v1/report/list | Добавили в ответ метода, в течение какого времени доступна ссылка для получения отчёта с report_type="SELLER_RETURNS". |
| /v1/report/returns/create | В ответ метода добавили, в течение какого срока можно получить отчёт по идентификатору. |
| /v1/report/stock/create | Метод устарел, удалили его из документации. Используйте /v1/report/warehouse/stock. |
| /v1/report/discounted/info | Метод устарел, удалили его из документации. Чтобы получить отчёт об уценённых товарах, запустите формирование через /v1/report/discounted/create и получите его через /v1/report/info. |
| /v1/report/discounted/list | Метод устарел, удалили его из документации. Чтобы получить список отчётов об уценённых товарах, сделайте запрос метода /v1/report/info с report_type="SELLER_PRODUCT_DISCOUNTED". |
| /v1/report/products/movement/create | Метод устарел, удалили его из документации. |
| Метод | Что изменилось |
|---|---|
| — | В раздел Порядок работы с методами добавили подраздел Схема rFBS Express с доставкой в пункт выдачи. |
| Метод | Что изменилось |
|---|---|
| — | Дополнили таблицу Частые ошибки. Добавили описания ошибок в методах: • /v2/products/stocks • /v3/posting/fbs/ship • /v4/posting/fbs/ship • /v2/posting/fbs/package-label • /v2/posting/fbs/act/create • /v2/posting/fbs/cancel • /v2/product/import |
| /v1/posting/carriage-available/list /v2/posting/fbs/act/create /v2/posting/fbs/act/check-status /v2/posting/fbs/act/get-pdf |
Для продавцов из СНГ остаются бумажные акты приёма-передачи при работе по схеме FBS. Дополнили описания методов — указали, какие документы можно получить продавцам из России и СНГ. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/carriage-available/list /v2/posting/fbs/act/create /v2/posting/fbs/act/check-status /v2/posting/fbs/act/get-pdf /v2/posting/fbs/digital/act/check-status /v2/posting/fbs/digital/act/get-pdf |
Отказались от актов приёма-передачи при работе по схеме FBS — теперь вместо них можно получить лист отгрузки. Обновили описания методов, в которых затрагивались акты, и порядок работы с ними: • Схема FBS Стандарт: изменили пункты 6–11. • Схема FBS PickUp с доверительной приёмкой: изменили пункты 6–8. Подробнее об изменениях на dev.ozon.ru |
| Метод | Что изменилось |
|---|---|
| /v1/description-category/tree | Добавили новую версию метода для получения дерева категорий и типов товаров. |
| /v1/description-category/attribute | Добавили новую версию метода для получения характеристик категории и типа товара. |
| /v1/description-category/attribute/values | Добавили новую версию метода для получения значений характеристики. |
| /v2/category/tree /v3/category/attribute /v2/category/attribute/values |
Методы устаревают и будут отключены в будущем. Переключитесь на новые версии — указали их в описании методов. |
| /v3/products/info/attributes /v2/product/info /v2/product/info/list |
Добавили параметр description_category_id в ответах методов и указали, как его использовать. Пометили параметр category_id в ответах методов как устаревающий и указали, как его использовать. |
| — | В разделе Порядок работы с методами → Выгрузите атрибуты и характеристики Ozon обновили версии методов. |
| Метод | Что изменилось |
|---|---|
| /v1/barcode/add | Добавили метод для привязки штрихкодов к товарам. |
| /v1/barcode/generate | Добавили метод для создания штрихкодов на товары. |
| Метод | Что изменилось |
|---|---|
| /v2/products/stocks | Добавили описание ошибки MP_DELIVERY_ONLY_3PL_ERROR:• в описание параметра result.errors в ответе метода,• в раздел «Частые ошибки». |
| Метод | Что изменилось |
|---|---|
| /v4/product/info/prices | Добавили информацию о работе параметров fbo_direct_flow_trans_max_amount и fbo_direct_flow_trans_min_amount в описание метода. |
| /v2/product/info | Добавили информацию о работе параметра min_price в описание метода. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/data | Добавили ограничения для продавцов без Premium-подписки: • в описание метода, • в описание параметров date_from, dimension и metrics в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Обновили описание параметра price в запросе метода. Указали, какой должна быть разница между price и old_price. |
| Метод | Что изменилось |
|---|---|
| /v1/report/transactions/create | Метод устарел, удалили его из документации. Используйте /v3/finance/transaction/list. |
| /v2/product/info/limit /v3/product/info/limit |
Методы устарели, удалили их документации. Используйте /v4/product/info/limit. |
| /v1/report/products/prices/create | Метод устарел, удалили его из документации. Используйте /v4/product/info/price. |
| /v1/analytics/item_turnover | Метод устарел, удалили его из документации. Чтобы получить отчёт по оборачиваемости FBO, запросите его в личном кабинете. |
| /v1/analytics/stock_on_warehouses | Метод устарел, удалили его из документации. Используйте /v2/analytics/stock_on_warehouses. |
| /v2/returns/company/fbs | Метод устарел, удалили его из документации. Используйте /v3/returns/company/fbs. |
| /v1/report/finance/create | Метод устарел, удалили его из документации. Используйте /v1/finance/cash-flow-statement/list. |
| /v2/returns/company/fbo | Метод устарел, удалили его из документации. Используйте /v3/returns/company/fbo. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/data | Удалили метрики из параметра metrics в запросе метода: • adv_view_pdp, • adv_view_search_category, • adv_view_all, • adv_sum_all, • postings, • postings_premium. |
| /v1/invoice/create-or-update | Добавили параметры HS_code, date, number, price и price_currency в запрос метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/info/stocks-by-warehouse/fbs | Добавили параметры sku в запрос метода и result.sku в ответ метода.Добавили дату отключения параметров fbs_sku в запрос метода и result.fbs_sku в ответ метода. |
| /v2/product/info | Добавили параметр result.sku в ответ метода.Добавили дату отключения параметров result.fbs_sku и result.fbo_sku в ответ метода. |
| /v2/product/info/list | Добавили параметр result.items.sku в ответ метода.Добавили дату отключения параметров result.items.fbs_sku и result.items.fbo_sku в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v4/product/info/prices | Добавили в ответ метода параметры: • result.items.acquiring,• result.items.comissions.sales_percent_fbo,• result.items.comissions.sales_percent_fbs.Дополнили в ответе методов описания параметров: • result.items.comissions.fbs_first_mile_min_amount,• result.items.comissions.fbs_first_mile_max_amount,• result.items.comissions.sales_percent. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Добавили параметр prices.price_strategy_enabled в запрос метода. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/act/get-barcode /v2/posting/fbs/act/get-pdf /v2/posting/fbs/digital/act/get-pdf /v2/posting/fbs/package-label /v2/posting/fbs/act/get-container-labels |
Обновили схемы и примеры для ответов методов: методы возвращают результат в бинарном виде. |
| /v1/posting/fbs/package-label/create | Обновили пример ответа. |
| /v1/posting/fbs/package-label/get | Добавили пример ответа. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/act/get-barcode | Удалили параметр doc_type из запроса метода. |
| /v2/posting/fbs/act/get-barcode/text | Добавили метод, в котором можно получить значение штрихода из ответа /v2/posting/fbs/act/get-barcode. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbo | Добавили описание параметра filter.status в запросе метода.Дополнили описание параметра returns.status_name в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbs | Добавили параметры returns.exemplar_id и returns.return_barcode в ответ метода.Изменили описания параметров returns.id, returns.return_clearing_id и clearing_id в ответе метода. |
| Метод | Что изменилось |
|---|---|
| — | Дополнили описание для всех схем FBS и rFBS в разделе Порядок работы с методами → Управляйте заказами FBO, FBS и rFBS. Добавили изначальные статусы отправлений, а также ограничение для сборки заказа. |
| Метод | Что изменилось |
|---|---|
| — | Добавили описание уведомления TYPE_CREATE_OR_UPDATE_ITEM в раздел Пуш-уведомления → Уведомления, которые отправляет Ozon. |
| — | 15 июля 2023 года пуш-уведомления TYPE_CREATE_ITEM и TYPE_UPDATE_ITEM будут отключены. Добавили предупреждение в описания уведомлений. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Добавили параметр result.postings.prr_option в ответы методов. |
| /v3/posting/fbs/get | Добавили параметры result.prr_option.code, result.prr_option.price, result.prr_option.currency_code, result.prr_option.floor в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/fbs/timeslot/set | Обновили пример запроса. |
| /v2/posting/fbo/list | Исправили формат даты в примере ответа. |
| /v2/posting/fbs/cancel /v2/posting/fbs/product/cancel |
Дополнили описания методов. |
| /v2/posting/fbs/act/list | Добавили значение статуса closed в описание параметра filter.status в запросе метода. |
| /v1/product/unarchive | С 14 июня 2023 метод не работает. Добавили предупреждение в описание метода и раздел Отключение методов. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/get | Добавили параметры jw_uin и products_requiring_jw_uin в ответ метода. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Добавили параметр products_requiring_jw_uin в ответы методов. |
| /v4/fbs/posting/product/exemplar/set | Добавили параметр jw_uin в запрос метода. |
| /v4/fbs/posting/product/exemplar/status | Добавили параметры jw_uin, jw_uin_check_status и jw_uin_error_codes в ответ метода. |
| /v4/fbs/posting/product/exemplar/validate | Добавили параметр jw_uin в запрос и ответ метода. |
| /v1/product/archive /v1/product/unarchive |
Добавили ограничение на количество product_id, которые можно передать в одном запросе. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/act/get-barcode | Добавили метод получения штрихкода для отгрузки товара. |
| Метод | Что изменилось |
|---|---|
| /v2/fbs/posting/tracking-number/set | Добавили ограничение на добавление трек-номеров в описание метода. |
| /v1/supplier/available_warehouses | Добавили метод для проверки загруженности складов Ozon. |
| Метод | Что изменилось |
|---|---|
| /v1/product/attributes/update | Добавили метод для обновления характеристик товара. |
| Метод | Что изменилось |
|---|---|
| — | Обновили инструкцию Как получить API-ключ. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/cash-flow-statement/list | Добавили необязательный параметр with_details в запрос метода и параметр details в ответ метода. |
| /v1/pricing-strategy/competitors/list | Добавили метод для получения списка конкурентов. |
| /v1/pricing-strategy/list | Добавили метод для получения списка стратегий ценообразования. |
| /v1/pricing-strategy/create | Добавили метод для создания стратегии ценообразования. |
| /v1/pricing-strategy/info | Добавили метод для получения информации о стратегии ценообразования. |
| /v1/pricing-strategy/update | Добавили метод для изменения списка выбранных конкурентов и названия стратегии ценообразования. |
| /v1/pricing-strategy/products/add | Добавили метод для добавления товаров в стратегию ценообразования. |
| /v1/pricing-strategy/strategy-ids-by-product-ids | Добавили метод для проверки привязки товара к стратегии ценообразования. |
| /v1/pricing-strategy/products/list | Добавили метод для получения списка товаров, которые привязаны к стратегии ценообразования. |
| /v1/pricing-strategy/products/delete | Добавили метод для удаления товаров из стратегии ценообразования. |
| /v1/pricing-strategy/product/info | Добавили метод для получения цены товара у конкурента. |
| /v1/pricing-strategy/status | Добавили метод для включения и отключения стратегии ценообразования. |
| /v1/pricing-strategy/delete | Добавили метод для удаления стратегии ценообразования. |
| — | В разделе Порядок работы с методами добавили подраздел Настройте стратегии ценообразования. |
| Метод | Что изменилось |
|---|---|
| /v1/product/info/subscription | Добавили метод для получения количества пользователей, подписанных на товары. |
| /v2/product/info | Добавили параметр result.price_indexes в ответ метода.Пометили параметр result.price_index в ответе как неактуальный. |
| /v2/product/info/list /v4/product/info/prices |
Добавили параметр result.items.price_indexes в ответ метода.Пометили параметр result.items.price_index в ответе как неактуальный. |
| /v3/posting/fbs/get | Добавили параметр result.substatus в ответ метода. |
| /v3/posting/fbs/list | Добавили параметр result.postings.substatus в ответ метода.Дополнили описание параметра result.postings.status в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/supply-order/list | Добавили метод для получения списка заявок на поставку на склад Ozon. |
| /v1/supply-order/get | Добавили метод для получения информации о заявке на поставку. |
| /v1/supply-order/items | Добавили метод для получения списка товаров в заявке на поставку. |
| — | Добавили подраздел Схема FBO → Получите информацию о заявках на поставку в раздел Порядок работы с методами. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbs | Добавили новую версию метода для получения информации о возвратах FBS. |
| Метод | Что изменилось |
|---|---|
| — | В раздел Пуш-уведомления → Как подключить добавили IP-адреса, с которых отправляются уведомления. |
| /v2/returns/company/fbs | Добавили описание статусов moving, disposed и disposing для параметра filter.status в запросе метода. |
| /v3/finance/transaction/list | Дополнили описание параметра filter.operation_type в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/finance/transaction/list | Обновили описание метода: теперь максимальный период, за который можно получить информацию в одном запросе — 1 месяц. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/fbs/timeslot/set | Добавили метод для переноса даты доставки отправления. |
| /v1/posting/fbs/timeslot/change-restrictions | Добавили метод для получения доступных дат для переноса доставки и количества доступных переносов. |
| Метод | Что изменилось |
|---|---|
| /v2/analytics/stock_on_warehouses | Добавили новую версию метода для получения отчёта по товарам и остаткам. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/global/etgb | Добавили метод для получения таможенных деклараций ETGB. |
| Метод | Что изменилось |
|---|---|
| — | В разделе Пуш-уведомления → Как подключить обновили инструкцию: теперь подключать пуш-уведомления нужно в личном кабинете. В раздел Уведомления, которые отправляет Ozon добавили описания новых типов уведомлений: • TYPE_NEW_MESSAGE • TYPE_UPDATE_MESSAGE • TYPE_MESSAGE_READ • TYPE_CHAT_CLOSED |
| /v1/posting/fbs/package-label/create /v1/posting/fbs/package-label/get |
Добавили методы для асинхронного формирования этикеток. |
| Метод | Что изменилось |
|---|---|
| /v2/returns/company/fbo /v3/product/info/limit /v1/analytics/stock_on_warehouses /v1/analytics/item_turnover |
1 апреля 2023 отключим эти методы. Добавили предупреждение в описание методов и в раздел Отключение методов. |
| /v1/auto/bookings/get /v1/auto/bookings/list /v1/auto/cbos/list /v1/auto/modifications/list /v1/auto/offers/create /v1/auto/offers/list /v1/auto/offers/update |
Удалили раздел Автомобили из документации. |
| Метод | Что изменилось |
|---|---|
| /v4/product/info/limit | Добавили метод для получения лимитов на ассортимент, создание и обновление товаров. |
| Метод | Что изменилось |
|---|---|
| /v1/product/update/discount | Добавили метод для установки скидки на уценённые товары, продающиеся по схеме FBS. |
| /v2/posting/fbs/act/list | Обновили описание параметра filter.status в запросе. |
| /v3/category/attribute | Добавили поле result.attributes.category_dependent в ответ метода. |
| Метод | Что изменилось |
|---|---|
| — | Дополнили таблицу «Частые ошибки». Добавили описания ошибок для метода /v2/posting/fbs/act/create. |
| /v2/product/info /v1/product/info/list |
В ответы методов добавили поле updated_at: дата последнего обновления товара. |
| Метод | Что изменилось |
|---|---|
| /v2/product/import /v1/product/import-by-sku |
В запросах методов обновили описание параметра offer_id: максимальная длина передаваемого значения — 50 символов. |
| /v1/product/update/offer-id | В запросе метода обновили описание параметра new_offer_id: максимальная длина передаваемого значения — 50 символов. |
| Метод | Что изменилось |
|---|---|
| /v2/category/tree | В запросе метода обновили значение параметра language для китайского языка. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/multiboxqty/set | Добавили метод для передачи количества коробок в многокоробочных отправлениях. |
| /v3/posting/fbs/get | В ответ метода добавили поля для получения информации о многокоробочных отправлениях: result.is_multibox и result.multi_box_qty. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
В ответы методов добавили поля для получения информации о многокоробочных отправлениях: result.postings.is_multibox и result.postings.multi_box_qty. |
| /v2/posting/fbs/act/get-postings | В ответ метода добавили поле result.multi_box_qty для получения количества коробок в многокоробочных отправлениях. |
| Метод | Что изменилось |
|---|---|
| — | Обновили срок подключения пуш-уведомлений. |
| /v1/supplier/orders/{orderId}/waybill_acceptance_results /v1/supplier/waybill_acceptance_results/{waybillId} |
Убрали методы из документации. |
| /v3/category/attribute | В ответ метода добавили поле result.attributes.is_aspect. |
| /v2/product/info /v2/product/info/list |
В ответы методов добавили поле barcodes для получения всех штрихкодов товара. |
Возвращает категории и типы для товаров в виде дерева.
Создание товаров доступно только в категориях последнего уровня, сравните именно их с категориями на своей площадке. Категории не создаются по запросу пользователя.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| language | string Default: "DEFAULT" Enum: "DEFAULT" "RU" "EN" "TR" "ZH_HANS" Язык в ответе:
По умолчанию используется русский язык. |
Array of objects Список категорий. | |||||||||||||
Array ()
| |||||||||||||
{- "language": "DEFAULT"
}{- "result": [
- {
- "description_category_id": 17027492,
- "category_name": "Канцелярские товары",
- "disabled": false,
- "children": [
- {
- "description_category_id": 17029016,
- "category_name": "Печати и штампы",
- "disabled": false,
- "children": [
- {
- "type_name": "Пистолет-маркиратор",
- "type_id": 970778135,
- "disabled": false,
- "children": [ ]
}
]
}
]
}
]
}Получение характеристик для указанных категории и типа товара.
Если у dictionary_id значение 0, у атрибута нет вложенных справочников.
Если значение другое, то справочники есть. Запросите их методом /v1/description-category/attribute/values.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| description_category_id | integer <int64> Идентификатор категории. |
| language | string Default: "DEFAULT" Enum: "DEFAULT" "RU" "EN" "TR" "ZH_HANS" Язык в ответе:
По умолчанию используется русский язык. |
| type_id | integer <int64> Идентификатор типа товара. |
Array of objects Результат запроса. | |||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||
{- "description_category_id": 200000933,
- "language": "DEFAULT",
- "type_id": 93080
}{- "result": [
- {
- "id": 31,
- "attribute_complex_id": 0,
- "name": "Бренд в одежде и обуви",
- "description": "Укажите наименование бренда, под которым произведён товар. Если товар не имеет бренда, используйте значение \"Нет бренда\"",
- "type": "string",
- "is_collection": false,
- "is_required": true,
- "is_aspect": false,
- "max_value_count": 0,
- "group_name": "",
- "group_id": 0,
- "dictionary_id": 28732849,
- "category_dependent": true
}
]
}Возвращает справочник значений характеристики.
Узнать, есть ли вложенный справочник, можно через метод /v1/description-category/attribute.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| attribute_id | integer <int64> Идентификатор характеристики. |
| description_category_id | integer <int64> Идентификатор категории. |
| language | string Default: "DEFAULT" Enum: "DEFAULT" "RU" "EN" "TR" "ZH_HANS" Язык в ответе:
По умолчанию используется русский язык. |
| last_value_id | integer <int64> Идентификатор справочника, с которого нужно начать ответ. Если |
| limit | integer <int64> Количество значений в ответе:
|
| type_id | integer <int64> Идентификатор типа товара. |
| has_next | boolean Признак, что в ответе вернулась только часть значений характеристики:
| ||||||||
Array of objects Значения характеристики. | |||||||||
Array ()
| |||||||||
{- "attribute_id": 85,
- "description_category_id": 17054869,
- "language": "DEFAULT",
- "last_value_id": 0,
- "limit": 100,
- "type_id": 97311
}{- "result": [
- {
- "id": 5055881,
- "value": "Sunshine",
- "info": "",
}, - {
- "id": 5056737,
- "value": "Essence",
- "info": "Красота и здоровье",
}
], - "has_next": true
}Возвращает справочные значения характеристики по заданному значению value в запросе.
Узнать, есть ли вложенный справочник, можно через метод /v1/description-category/attribute.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| attribute_id | integer <int64> Идентификатор характеристики. |
| description_category_id | integer <int64> Идентификатор категории. |
| limit | integer <int64> Количество значений в ответе:
|
| type_id | integer <int64> Идентификатор типа товара. |
| value | string Значение, по которому система будет искать справочные значения. Минимум — 2 символа. |
Array of objects Значения характеристики. | |||||||||
Array ()
| |||||||||
{- "attribute_id": 0,
- "description_category_id": 0,
- "limit": 0,
- "type_id": 0,
- "value": "string"
}{- "result": [
- {
- "id": 0,
- "info": "string",
- "picture": "string",
- "value": "string"
}
]
}Метод для создания товаров и обновления информации о них.
В сутки можно создать или обновить определённое количество товаров. Чтобы узнать лимит, используйте
/v4/product/info/limit. Если количество загрузок и обновлений товаров
превысит лимит, появится ошибка item_limit_exceeded.
В одном запросе можно передать до 100 товаров. Каждый товар — это отдельный элемент в массиве items. Укажите
всю информацию о товаре: его характеристики, штрихкод, изображения, габариты, цену и валюту цены.
При обновлении товара передайте в запросе всю информацию о нём.
Указанная валюта должна совпадать с той, которая установлена в настройках личного кабинета. По умолчанию передаётся RUB — российский рубль.
Например, если у вас установлена валюта юань, передавайте значение CNY, иначе вернётся ошибка.
Товар не будет создан или обновлён, если вы заполните неправильно или не укажете:
depth, width, height, dimension_unit, weight, weight_unit. Не пропускайте эти параметры в запросе и не указывайте 0.Для некоторых характеристик можно использовать HTML-теги.
После модерации товар появится в вашем личном кабинете, но не будет виден пользователям, пока вы не выставите его на продажу.
Каждый товар в запросе — отдельный элемент массива items.
Чтобы объединить две карточки, для каждой передайте 9048 в массиве attributes. Все атрибуты в этих карточках, кроме размера или цвета, должны совпадать.
Для загрузки передайте в запросе ссылки на изображения в общедоступном облачном хранилище. Формат изображения по ссылке — JPG или PNG.
Изображения в массиве images располагайте в соответствии с желаемым порядком на сайте. Для загрузки главного
изображения товара используйте параметр primary_image. Если не передать значение primary_image, главным будет
первое изображение в массиве images.
Для каждого товара вы можете загрузить до 15 изображений, включая главное.
Если передать значение primary_image, максимальное количество изображений в images — 14.
Если параметр primary_image пустой, то в images можно передать до 15 изображений.
Для загрузки изображений 360 используйте поле images360, для загрузки маркетингового цвета — color_image.
Если вы хотите изменить состав или порядок изображений, получите информацию с помощью методов
/v2/product/info или
/v2/product/info/list — в них отображается текущий порядок и
состав изображений. Скопируйте данные полей images, images360, color_image, измените и дополните состав или
порядок в соответствии с необходимостью.
Для загрузки передайте в запросе ссылки на видео.
Для этого в параметре complex_attributes передайте объект. В нём в массиве attributes передайте 2 объекта с complex_id = 100001:
В первом передайте укажите id = 21841 и в массиве values передайте объект с ссылкой на видео.
Пример:
{
"complex_id": 100001,
"id": 21841,
"values": [
{
"value": "https://www.youtube.com/watch?v=ZwM0iBn03dY"
}
]
}Во втором укажите значение id = 21837 и в массиве values передайте объект с названием видео.
Пример:
{
"complex_id": 100001,
"id": 21837,
"values": [
{
"value": "videoName_1"
}
]
}Если вы хотите загрузить несколько видео, передавайте значения для каждого видео в разных объектах массива values.
Пример:
{
"complex_id": 100001,
"id": 21837,
"values": [
{
"value": "videoName_1"
},
{
"value": "videoName_2"
}
]
},
{
"complex_id": 100001,
"id": 21841,
"values": [
{
"value": "https://www.youtube.com/watch?v=ZwM0iBn03dY"
},
{
"value": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
]
}Вы можете добавить в карточку товара таблицу размеров, созданную с помощью конструктора. Передайте её в массиве attributes в формате JSON как Rich-контент id = 13164.
Конструктор в формате JSON
Подробнее о конструкторе в Базе знаний продавца
Вы можете загрузить видеообложку через complex_attributes.
Пример:
"complex_attributes": [
{
"attributes": [
{
"id": 21845,
"complex_id": 100002,
"values": [
{
"dictionary_value_id": 0,
"value": "https://v.ozone.ru/vod/video-10/01GFATWQVCDE7G5B721421P1231Q7/asset_1.mp4"
}
]
}
]
}
]| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Массив данных. |
object Результаты запроса. | |||
| |||
{- "items": [
- {
- "attributes": [
- {
- "complex_id": 0,
- "id": 5076,
- "values": [
- {
- "dictionary_value_id": 971082156,
- "value": "Стойка для акустической системы"
}
]
}, - {
- "complex_id": 0,
- "id": 9048,
- "values": [
- {
- "value": "Комплект защитных плёнок для X3 NFC. Темный хлопок"
}
]
}, - {
- "complex_id": 0,
- "id": 8229,
- "values": [
- {
- "dictionary_value_id": 95911,
- "value": "Комплект защитных плёнок для X3 NFC. Темный хлопок"
}
]
}, - {
- "complex_id": 0,
- "id": 85,
- "values": [
- {
- "dictionary_value_id": 5060050,
- "value": "Samsung"
}
]
}, - {
- "complex_id": 0,
- "id": 10096,
- "values": [
- {
- "dictionary_value_id": 61576,
- "value": "серый"
}
]
}
], - "barcode": "112772873170",
- "description_category_id": 17028922,
- "new_description_category_id": 0,
- "color_image": "",
- "complex_attributes": [ ],
- "currency_code": "RUB",
- "depth": 10,
- "dimension_unit": "mm",
- "height": 250,
- "images": [ ],
- "images360": [ ],
- "name": "Комплект защитных плёнок для X3 NFC. Темный хлопок",
- "offer_id": "143210608",
- "old_price": "1100",
- "pdf_list": [ ],
- "price": "1000",
- "primary_image": "",
- "vat": "0.1",
- "weight": 100,
- "weight_unit": "g",
- "width": 150
}
]
}{- "result": {
- "task_id": 172549793
}
}Позволяет получить статус создания карточки товара.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| task_id | integer <int64> Код задачи на импорт товаров. |
object | |||||
| |||||
{- "task_id": "172549793"
}{- "result": {
- "items": [
- {
- "offer_id": "143210608",
- "product_id": 137285792,
- "status": "imported",
- "errors": [ ]
}
], - "total": 1
}
}Метод создаёт копию карточки товара с указанным SKU.
Создать копию не получится, если продавец запретил копирование своих карточек.
Обновить товар по SKU нельзя.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects <= 1000 items Информация о товарах. |
object | |||||
| |||||
{- "items": [
- {
- "sku": 298789742,
- "name": "string",
- "offer_id": "91132",
- "currency_code": "RUB",
- "old_price": "2590",
- "price": "2300",
- "vat": "0.1"
}
]
}{- "result": {
- "task_id": 176594213,
- "unmatched_sku_list": [ ]
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Товары и характеристики, которые нужно обновить. |
| task_id | integer <int64> Номер задания на обновление товаров. Чтобы проверить статус обновления, передайте полученное значение в метод /v1/product/import/info. |
{- "items": [
- {
- "attributes": [
- {
- "complex_id": 0,
- "id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "string"
}
]
}
], - "offer_id": "string"
}
]
}{- "task_id": 0
}Метод для загрузки или обновления изображений товара.
При каждом вызове метода передавайте все изображения, которые должны быть на карточке товара. Например, если вы вызвали метод и загрузили 10 изображений, а затем вызвали метод второй раз и загрузили ещё одно, то все 10 предыдущих сотрутся.
Для загрузки передайте адрес ссылки на изображение в общедоступном облачном хранилище. Формат изображения по ссылке — JPG или PNG.
Изображения в массиве images располагайте в соответствии с желаемым порядком на сайте. Главным будет
первое изображение в массиве.
Для каждого товара вы можете загрузить до 15 изображений.
Для загрузки изображений 360 используйте поле images360, для загрузки маркетингового цвета — color_image.
Если вы хотите изменить состав или порядок изображений, получите информацию с помощью методов
/v2/product/info или
/v2/product/info/list — в них отображается текущий порядок и
состав изображений. Скопируйте данные полей images, images360, color_image, измените и дополните состав или
порядок в соответствии с необходимостью.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| color_image | string Маркетинговый цвет. |
| images | Array of strings Массив ссылок на изображения. Изображения в массиве расположены в порядке их расположения на сайте. Первое изображение в массиве будет главным. |
| images360 | Array of strings Массив изображений 360. До 70 штук. Формат: адрес ссылки на изображение в общедоступном облачном хранилище. Формат изображения по ссылке — JPG. |
| product_id | integer <int64> Идентификатор товара. |
object Результат работы метода. | |||
| |||
{- "color_image": "string",
- "images": [
- "string"
], - "images360": [
- "string"
], - "product_id": 0
}{- "result": {
- "pictures": [
- {
- "is_360": true,
- "is_color": true,
- "is_primary": true,
- "product_id": 0,
- "state": "string",
- "url": "string"
}
]
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| product_id required | Array of strings <int64> <= 1000 items Идентификаторы товаров. |
Array of objects Изображения товаров. | |||||||||||
Array ()
| |||||||||||
{- "product_id": [
- "string"
]
}{- "items": [
- {
- "product_id": 0,
- "primary_photo": [
- "string"
], - "photo": [
- "string"
], - "color_photo": [
- "string"
], - "photo_360": [
- "string"
]
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| product_id | Array of strings <int64> Список идентификаторов товаров. |
object Результат работы метода. | |||
| |||
{- "product_id": [
- "string"
]
}{- "result": {
- "pictures": [
- {
- "is_360": true,
- "is_color": true,
- "is_primary": true,
- "product_id": 0,
- "state": "string",
- "url": "string"
}
]
}
}При использовании фильтра по идентификатору offer_id или product_id все остальные параметры не обязательны.
За один раз можно использовать только одну группу идентификаторов, не больше 1000 товаров.
Если вы не используете для отображения идентификаторы, укажите limit и last_id при последующих запросах.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по товарам. | |
| last_id | string Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
| limit | integer <int64> Количество значений на странице. Минимум — 1, максимум — 1000. |
object Результат. | |||||||
| |||||||
{- "filter": {
- "offer_id": [
- "136748"
], - "product_id": [
- "223681945"
], - "visibility": "ALL"
}, - "last_id": "",
- "limit": 100
}{- "result": {
- "items": [
- {
- "product_id": 223681945,
- "offer_id": "136748"
}
], - "total": 1,
- "last_id": "bnVсbA=="
}
}Уточняйте минимальную цену товара после применения всех акций в личном кабинете.
Параметр min_price из ответа метода на доработке и возвращает 0.
Параметр active_product устарел, используйте значения параметра visible.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| offer_id | string Идентификатор товара в системе продавца — артикул. |
| product_id | integer <int64> Идентификатор товара. |
| sku | integer <int64> Идентификатор товара в системе Ozon — SKU. |
object Результаты запроса. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{- "offer_id": "",
- "product_id": 137208233,
- "sku": 0
}{- "result": {
- "id": 137208233,
- "name": "Комплект защитных плёнок для X3 NFC. Темный хлопок",
- "offer_id": "143210586",
- "is_archived": false,
- "is_autoarchived": false,
- "barcode": "",
- "barcodes": [
- "2335900005",
- "7533900005"
], - "buybox_price": "",
- "category_id": 17038062,
- "type_id": 0,
- "created_at": "2021-10-21T15:48:03.529178Z",
- "has_discounted_item": true,
- "is_discounted": true,
- "discounted_stocks": {
- "coming": 0,
- "present": 0,
- "reserved": 0
}, - "currency_code": "RUB",
- "description_category_id": 0,
- "marketing_price": "",
- "min_price": "",
- "old_price": "",
- "price": "590.0000",
- "sources": [
- {
- "is_enabled": true,
- "sku": 522759607,
- "source": "fbo"
}, - {
- "is_enabled": true,
- "sku": 522759608,
- "source": "fbs"
}
], - "stocks": {
- "coming": 0,
- "present": 0,
- "reserved": 0
}, - "errors": [ ],
- "updated_at": "2023-02-09T06:46:44.152Z",
- "vat": "0.0",
- "visible": false,
- "visibility_details": {
- "has_price": true,
- "has_stock": false,
- "active_product": false
}, - "price_indexes": {
- "external_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}, - "ozon_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}, - "price_index": "WITHOUT_INDEX",
- "self_marketplaces_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}
}, - "commissions": [
- {
- "delivery_amount": 0,
- "percent": 0,
- "return_amount": 0,
- "sale_schema": "string",
- "value": 0
}
], - "volume_weight": 0.1,
- "is_prepayment": false,
- "is_prepayment_allowed": true,
- "images360": [ ],
- "is_kgt": false,
- "color_image": "",
- "status": {
- "state": "imported",
- "state_failed": "imported",
- "moderate_status": "",
- "decline_reasons": [ ],
- "validation_state": "pending",
- "state_name": "Не продается",
- "state_description": "Не создан",
- "is_failed": true,
- "is_created": false,
- "state_tooltip": "",
- "item_errors": [
- {
- "code": "error_attribute_values_empty",
- "field": "attribute",
- "attribute_id": 9048,
- "state": "imported",
- "level": "error",
- "description": "Не заполнен обязательный атрибут. Иногда мы обновляем обязательные атрибуты или добавляем новые. Отредактируйте товар или загрузите новый XLS-шаблон с актуальными атрибутами. ",
- "optional_description_elements": { },
- "attribute_name": "Название модели"
}, - {
- "code": "error_attribute_values_empty",
- "field": "attribute",
- "attribute_id": 5076,
- "state": "imported",
- "level": "error",
- "description": "Не заполнен обязательный атрибут. Иногда мы обновляем обязательные атрибуты или добавляем новые. Отредактируйте товар или загрузите новый XLS-шаблон с актуальными атрибутами. ",
- "optional_description_elements": { },
- "attribute_name": "Рекомендовано для"
}, - {
- "code": "error_attribute_values_empty",
- "field": "attribute",
- "attribute_id": 8229,
- "state": "imported",
- "level": "error",
- "description": "Не заполнен обязательный атрибут. Иногда мы обновляем обязательные атрибуты или добавляем новые. Отредактируйте товар или загрузите новый XLS-шаблон с актуальными атрибутами. ",
- "optional_description_elements": { },
- "attribute_name": "Тип"
}, - {
- "code": "error_attribute_values_empty",
- "field": "attribute",
- "attribute_id": 85,
- "state": "imported",
- "level": "error",
- "description": "Не заполнен обязательный атрибут. Иногда мы обновляем обязательные атрибуты или добавляем новые. Отредактируйте товар или загрузите новый XLS-шаблон с актуальными атрибутами. ",
- "optional_description_elements": { },
- "attribute_name": "Бренд"
}
], - "state_updated_at": "2021-10-21T15:48:03.927309Z"
}
}
}Метод для получения контент-рейтинга товаров, а также рекомендаций по его увеличению.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| skus | Array of strings <int64> Список SKU товаров, для которых нужно вернуть контент-рейтинг. |
Array of objects Контент-рейтинг товаров. | |||||||
Array ()
| |||||||
{- "skus": [
- "179737222"
]
}{- "products": [
- {
- "sku": 179737222,
- "rating": 42.5,
- "groups": [
- {
- "key": "media",
- "name": "Медиа",
- "rating": 70,
- "weight": 25,
- "conditions": [
- {
- "key": "media_images_2",
- "description": "Добавлено 2 изображения",
- "fulfilled": true,
- "cost": 50
}, - {
- "key": "media_images_3",
- "description": "Добавлено 3 изображения и более",
- "fulfilled": true,
- "cost": 20
}, - {
- "key": "media_image_3d",
- "description": "Добавлено 3D-изображение",
- "fulfilled": false,
- "cost": 15
}, - {
- "key": "media_video",
- "description": "Добавлено видео",
- "fulfilled": false,
- "cost": 15
}
], - "improve_attributes": [
- {
- "id": 4074,
- "name": "Код ролика на YouTube"
}, - {
- "id": 4080,
- "name": "3D-изображение"
}
], - "improve_at_least": 2
}, - {
- "key": "important_attributes",
- "name": "Важные атрибуты",
- "rating": 50,
- "weight": 30,
- "conditions": [
- {
- "key": "important_2",
- "description": "Заполнено 2 атрибута и более",
- "fulfilled": true,
- "cost": 50
}, - {
- "key": "important_50_percent",
- "description": "Заполнено более 50% атрибутов",
- "fulfilled": false,
- "cost": 25
}, - {
- "key": "important_70_percent",
- "description": "Заполнено более 70% атрибутов",
- "fulfilled": false,
- "cost": 25
}
], - "improve_attributes": [
- {
- "id": 4385,
- "name": "Гарантийный срок"
}, - {
- "id": 4389,
- "name": "Страна-изготовитель"
}, - {
- "id": 8513,
- "name": "Количество в упаковке, шт"
}, - {
- "id": 8590,
- "name": "Макс. диагональ, дюймы"
}, - {
- "id": 8591,
- "name": "Мин. диагональ, дюймы"
}, - {
- "id": 9336,
- "name": "Модель браслета/умных часов"
}, - {
- "id": 11046,
- "name": "Покрытие"
}, - {
- "id": 11047,
- "name": "Прозрачность покрытия"
}, - {
- "id": 11048,
- "name": "Дополнительные свойства покрытия"
}, - {
- "id": 11049,
- "name": "Вид стекла"
}, - {
- "id": 11603,
- "name": "Размер циферблата"
}
], - "improve_at_least": 6
}, - {
- "key": "other_attributes",
- "name": "Остальные атрибуты",
- "rating": 0,
- "weight": 25,
- "conditions": [
- {
- "key": "other_2",
- "description": "Заполнено 2 атрибута и более",
- "fulfilled": false,
- "cost": 50
}, - {
- "key": "other_50_percent",
- "description": "Заполнено более 50% атрибутов",
- "fulfilled": false,
- "cost": 50
}
], - "improve_attributes": [
- {
- "id": 4382,
- "name": "Размеры, мм"
}
], - "improve_at_least": 1
}, - {
- "key": "text",
- "name": "Текстовое описание",
- "rating": 50,
- "weight": 20,
- "conditions": [
- {
- "key": "text_annotation_100_chars",
- "description": "Аннотация более 100 знаков",
- "fulfilled": true,
- "cost": 25
}, - {
- "key": "text_annotation_500_chars",
- "description": "Аннотация более 500 знаков",
- "fulfilled": true,
- "cost": 25
}, - {
- "key": "text_rich",
- "description": "Заполнен Rich-контент",
- "fulfilled": false,
- "cost": 100
}
], - "improve_attributes": [
- {
- "id": 11254,
- "name": "Rich-контент JSON"
}
], - "improve_at_least": 1
}
]
}
]
}Метод для получения массива товаров по их идентификаторам.
В теле запроса должен быть массив однотипных идентификаторов, в ответе будет массив items.
Параметр active_product устарел, используйте значения параметра visible.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| offer_id | Array of strings Идентификатор товара в системе продавца — артикул. Максимальное количество товаров — 1000. |
| product_id | Array of strings <int64> Идентификатор товара. |
| sku | Array of integers <int64> Идентификатор товара в системе Ozon — SKU. |
object Результаты запроса. | |||
| |||
{- "offer_id": [
- "23",
- "010"
], - "product_id": [ ],
- "sku": [ ]
}{- "result": {
- "items": [
- {
- "id": 78712196,
- "name": "Как выбрать детские музыкальные инструменты. Ксилофон, бубен, маракасы и другие инструменты для детей до 6 лет. Мастер-класс о раннем музыкальном развитии от Монтессори-педагога",
- "offer_id": "010",
- "is_archived": false,
- "is_autoarchived": false,
- "barcode": "",
- "barcodes": [
- "2335900005",
- "7533900005"
], - "buybox_price": "",
- "description_category_id": 93726157,
- "type_id": 0,
- "created_at": "2021-06-03T03:40:05.871465Z",
- "images": [ ],
- "currency_code": "RUB",
- "marketing_price": "",
- "min_price": "",
- "old_price": "1000.0000",
- "price": "690.0000",
- "recommended_price": "",
- "sources": [
- {
- "is_enabled": true,
- "sku": 269628393,
- "source": "fbo"
}, - {
- "is_enabled": true,
- "sku": 269628396,
- "source": "fbs"
}
], - "has_discounted_item": true,
- "is_discounted": true,
- "discounted_stocks": {
- "coming": 0,
- "present": 0,
- "reserved": 0
}, - "state": "",
- "stocks": {
- "coming": 0,
- "present": 13,
- "reserved": 0
}, - "errors": [ ],
- "updated_at": "2023-02-09T06:46:44.152Z",
- "vat": "0.0",
- "visible": true,
- "visibility_details": {
- "has_price": false,
- "has_stock": true,
- "active_product": false,
- "reasons": { }
}, - "price_indexes": {
- "external_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}, - "ozon_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}, - "price_index": "WITHOUT_INDEX",
- "self_marketplaces_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}
}, - "images360": [ ],
- "is_kgt": false,
- "color_image": "",
- "status": {
- "state": "price_sent",
- "state_failed": "",
- "moderate_status": "approved",
- "decline_reasons": [ ],
- "validation_state": "success",
- "state_name": "Продается",
- "state_description": "",
- "is_failed": false,
- "is_created": true,
- "state_tooltip": "",
- "item_errors": [ ],
- "state_updated_at": "2021-07-26T04:50:08.486697Z"
}
}, - {
- "id": 76723583,
- "name": "Онлайн-курс по дрессировке собак \"Собака: инструкция по применению. Одинокий волк\"",
- "offer_id": "23",
- "barcode": "",
- "buybox_price": "",
- "category_id": 90635895,
- "created_at": "2021-05-26T20:26:07.565586Z",
- "images": [ ],
- "marketing_price": "",
- "min_price": "",
- "old_price": "12200.0000",
- "price": "6100.0000",
- "recommended_price": "",
- "sources": [
- {
- "is_enabled": true,
- "sku": 267684495,
- "source": "fbo"
}, - {
- "is_enabled": true,
- "sku": 267684498,
- "source": "fbs"
}
], - "state": "",
- "stocks": {
- "coming": 0,
- "present": 19,
- "reserved": 0
}, - "errors": [ ],
- "updated_at": "2023-02-09T06:46:44.152Z",
- "vat": "0.0",
- "visible": true,
- "visibility_details": {
- "has_price": false,
- "has_stock": true,
- "active_product": false,
- "reasons": { }
}, - "price_index": "0.00",
- "images360": [ ],
- "is_kgt": false,
- "color_image": "",
- "status": {
- "state": "price_sent",
- "state_failed": "",
- "moderate_status": "approved",
- "decline_reasons": [ ],
- "validation_state": "success",
- "state_name": "Продается",
- "state_description": "",
- "is_failed": false,
- "is_created": true,
- "state_tooltip": "",
- "item_errors": [ ],
- "state_updated_at": "2021-05-31T12:35:09.714641Z"
}
}
]
}
}Возвращает описание характеристик товара по его идентификатору. Товар можно искать по offer_id или product_id.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по товарам. | |
| last_id | string Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
| limit | integer <int64> Количество значений на странице. Минимум — 1, максимум — 1000. |
| sort_by | string Параметр, по которому товары будут отсортированы. |
| sort_dir | string Направление сортировки. |
Array of objects Результаты запроса. | |||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||
| last_id | string Идентификатор последнего значения на странице. Чтобы получить следующие значения, укажите полученное значение в следующем запросе в параметре | ||||||||||||||||||||||||||||||||||||||||
| total | string <int32> Количество товаров в списке. | ||||||||||||||||||||||||||||||||||||||||
{- "filter": {
- "product_id": [
- "213761435"
], - "visibility": "ALL"
}, - "limit": 100,
- "last_id": "okVsfA==«",
- "sort_dir": "ASC"
}{- "result": [
- {
- "id": 213761435,
- "barcode": "",
- "category_id": 17038062,
- "name": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G",
- "offer_id": "21470",
- "height": 10,
- "depth": 210,
- "width": 140,
- "dimension_unit": "mm",
- "weight": 50,
- "weight_unit": "g",
- "images": [
], - "images360": [ ],
- "pdf_list": [ ],
- "attributes": [
- {
- "attribute_id": 5219,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 970718176,
- "value": "универсальный"
}
]
}, - {
- "attribute_id": 11051,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 970736931,
- "value": "Прозрачный"
}
]
}, - {
- "attribute_id": 10100,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "false"
}
]
}, - {
- "attribute_id": 11794,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 970860783,
- "value": "safe"
}
]
}, - {
- "attribute_id": 9048,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G"
}
]
}, - {
- "attribute_id": 5076,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 39638,
- "value": "Xiaomi"
}
]
}, - {
- "attribute_id": 9024,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "21470"
}
]
}, - {
- "attribute_id": 10015,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "false"
}
]
}, - {
- "attribute_id": 85,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 971034861,
- "value": "Brand"
}
]
}, - {
- "attribute_id": 9461,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 349824787,
- "value": "Защитная пленка для смартфона"
}
]
}, - {
- "attribute_id": 4180,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G"
}
]
}, - {
- "attribute_id": 4191,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "Пленка предназначена для модели Xiaomi Redmi Note 10 Pro 5G. Защитная гидрогелевая пленка обеспечит защиту вашего смартфона от царапин, пыли, сколов и потертостей."
}
]
}, - {
- "attribute_id": 8229,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 91521,
- "value": "Защитная пленка"
}
]
}
], - "complex_attributes": [ ],
- "color_image": "",
- "last_id": ""
}
], - "total": 1,
- "last_id": "onVsfA=="
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| offer_id | string Идентификатор товара в системе продавца — артикул. |
| product_id | integer <int64> Идентификатор товара. |
object | |||||||||
| |||||||||
{- "offer_id": "5",
- "product_id": 73453843
}{- "result": {
- "id": 73453843,
- "offer_id": "5",
- "name": "Онлайн курс по дрессировке собак \"Воспитанная собака за 3 недели\"",
- "description": "Экспресс-курс - это сокращённый вариант курса \"Собака: инструкция по применению\", дающий базовый минимум знаний, навыков, умений. Это оптимальный вариант для совершения первых шагов по воспитанию!<br/><br/>Что дает Экспресс-курс:<ul><li>Контакт с собакой </li></ul>К концу экспресс-курса дрессировки вы получаете воспитанного друга и соратника, который ориентируется на вас в любой ситуации.<ul><li>Уверенность в безопасности</li></ul>Благополучие собаки: больше не будет срывов с поводка, преследования кошек, попыток съесть что-либо на улице и т. д.<ul><li>Комфортная жизнь</li></ul>Принципиально другой уровень общения, без раздражения, криков и недовольства поведением животного."
}
}Метод для получения информации о лимитах:
Если у вас есть лимит на ассортимент и вы израсходуете его, вы не сможете создавать новые товары.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Суточный лимит на создание товаров. | |
object Суточный лимит на обновление товаров. | |
object Лимит на ассортимент. |
{ }{- "daily_create": {
- "limit": 0,
- "reset_at": "2019-08-24T14:15:22Z",
- "usage": 0
}, - "daily_update": {
- "limit": 0,
- "reset_at": "2019-08-24T14:15:22Z",
- "usage": 0
}, - "total": {
- "limit": 0,
- "usage": 0
}
}Метод для изменения offer_id, привязанных к товарам. Вы можете изменить несколько offer_id.
Рекомендуем передавать до 250 значений в массиве.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Список пар с новыми и старыми значениями артикулов. |
Array of objects Список ошибок. | |||||
Array ()
| |||||
{- "update_offer_id": [
- {
- "new_offer_id": "string",
- "offer_id": "string"
}
]
}{- "errors": [
- {
- "message": "string",
- "offer_id": "string"
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| product_id | Array of integers <int64> Идентификаторы товаров. Вы можете передать до 100 идентификаторов за раз. |
| result | boolean Результат обработки запроса. |
{- "product_id": [
- "125529926"
]
}{- "result": true
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| product_id | Array of integers <int64> Идентификаторы товаров. Вы можете передать до 100 идентификаторов за раз. В сутки можно восстановить из архива не больше 10 товаров, которые были архивированы автоматически.
Если указать больше в одном запросе, вернётся ошибка |
| result | boolean Результат обработки запроса. |
{- "product_id": [
- "125529926"
]
}{- "result": true
}В одном запросе можно передать до 500 идентификаторов.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Идентификатор товара. |
Array of objects Статус обработки запроса. | |||||||
Array ()
| |||||||
{- "products": [
- {
- "offer_id": "033"
}
]
}{- "status": [
- {
- "offer_id": "033",
- "is_deleted": true,
- "error": ""
}
]
}Загрузите коды активации, если вы загружаете цифровые товары или услуги. Код активации привязывается к карточке цифрового товара.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| digital_codes | Array of strings Цифровые коды активации. |
| product_id | integer <int64> Идентификатор товара. |
object | |||
| |||
{- "digital_codes": [
- "764282654334"
], - "product_id": 73160317
}{- "result": {
- "task_id": 172549811
}
}Метод для получения статуса загрузки кодов активации для услуг и цифровых товаров.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| task_id | integer <int64> Идентификатор задачи на загрузку кодов активации, полученный в ответе метода /v1/product/upload_digital_codes. |
object | |||
| |||
{- "task_id": 178574231
}{- "result": {
- "status": "imported"
}
}Метод для получения количества пользователей, которые нажали Узнать о поступлении на странице товара.
Вы можете передать несколько товаров в запросе.
| skus | Array of strings <int64> Список SKU, идентификаторов товара в системе Ozon. |
Array of objects Результат работы метода. | |||||
Array ()
| |||||
{- "skus": [
- "string"
]
}{- "result": [
- {
- "count": 0,
- "sku": 0
}
]
}Метод для получения единого SKU по старым идентификаторам SKU FBS и SKU FBO. В ответе будут все SKU, связанные с переданными.
Метод может обработать любые SKU, даже скрытые или удалённые.
Передавайте до 200 SKU в одном запросе.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| sku | Array of strings <int64> Список SKU. |
Array of objects Информация о связанных SKU. | |
Array of objects Ошибки. |
{- "sku": [
- "string"
]
}{- "items": [
- {
- "availability": "string",
- "deleted_at": "2019-08-24T14:15:22Z",
- "delivery_schema": "string",
- "product_id": 0,
- "sku": 0
}
], - "errors": [
- {
- "code": "string",
- "sku": 0,
- "message": "string"
}
]
}Если у товара есть штрихкод, который не указан в системе Ozon, привяжите его с помощью этого метода. Если штрихкода нет, вы можете создать его через метод /v1/barcode/generate.
За один запрос вы можете назначить штрихкод не больше чем на 100 товаров. На одном товаре может быть до 100 штрихкодов. С одного аккаунта продавца можно использовать метод не больше 20 раз в минуту.
Array of objects Список штрихкодов и товаров. |
Array of objects Список ошибок. | |||||||||
Array ()
| |||||||||
{- "barcodes": [
- {
- "barcode": "string",
- "sku": 0
}
]
}{- "errors": [
- {
- "code": "string",
- "error": "string",
- "barcode": "string",
- "sku": 0
}
]
}Если у товара нет штрихкода, вы можете создать его с помощью этого метода. Если штрихкод уже есть, но он не указан в системе Ozon, вы можете привязать его через метод /v1/barcode/add.
За один запрос вы можете создать штрихкоды не больше чем для 100 товаров. С одного аккаунта продавца можно использовать метод не больше 20 раз в минуту.
| product_ids | Array of strings <int64> Идентификаторы товаров, для которых нужно создать штрихкод. |
Array of objects Ошибки при создании штрихкода. | |||||||||
Array ()
| |||||||||
{- "product_ids": [
- "string"
]
}{- "errors": [
- {
- "code": "string",
- "error": "string",
- "barcode": "string",
- "product_id": 0
}
]
}Позволяет изменить информацию о количестве товара в наличии:
За один запрос можно изменить наличие для 100 товаров. С одного аккаунта продавца можно отправить до 80 запросов в минуту.
Вы можете задать наличие товара только после того, как его статус сменится на price_sent.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Информация о товарах на складах. |
Array of objects Результаты запроса. | |||||||||
Array ()
| |||||||||
{- "stocks": [
- {
- "offer_id": "PG-2404С1",
- "product_id": 55946,
- "stock": 4
}
]
}{- "result": [
- {
- "product_id": 55946,
- "offer_id": "PG-2404С1",
- "updated": true,
- "errors": [ ]
}
]
}Позволяет изменить информацию о количестве товара в наличии.
За один запрос можно изменить наличие для 100 товаров. С одного аккаунта продавца можно отправить до 80 запросов в минуту.
Вы можете задать наличие товара только после того, как его статус сменится на price_sent.
Остатки крупногабаритных товаров можно обновлять только на предназначенных для них складах.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Информация о товарах на складах. |
Array of objects | |||||||||||||
Array ()
| |||||||||||||
{- "stocks": [
- {
- "offer_id": "PH11042",
- "product_id": 313455276,
- "quant_size": 1,
- "stock": 100,
- "warehouse_id": 22142605386000
}
]
}{- "result": [
- {
- "warehouse_id": 22142605386000,
- "product_id": 118597312,
- "quant_size": 1,
- "offer_id": "PH11042",
- "updated": true,
- "errors": [ ]
}
]
}Возвращает информацию о ĸоличестве товаров на сĸладах:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по товарам. | |
| last_id | string Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
| limit | integer <int64> Количество значений на странице. Минимум — 1, максимум — 1000. |
object Результаты запроса. | |||||||
| |||||||
{- "filter": {
- "offer_id": [
- "136834"
], - "product_id": [
- "214887921"
], - "visibility": "ALL"
}, - "last_id": "",
- "limit": 100
}{- "result": {
- "items": [
- {
- "product_id": 214887921,
- "offer_id": "136834",
- "stocks": [
- {
- "type": "fbs",
- "present": 170,
- "reserved": 0
}, - {
- "type": "fbo",
- "present": 0,
- "reserved": 0
}, - {
- "type": "crossborder",
- "present": 170,
- "reserved": 0
}
]
}
], - "total": 1,
- "last_id": "anVsbA=="
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| sku | Array of strings <int64> SKU товара. |
Array of objects Результат работы метода. | |||||||||||||
Array ()
| |||||||||||||
{- "sku": [
- "string"
]
}{- "result": [
- {
- "sku": 0,
- "present": 0,
- "product_id": 0,
- "reserved": 0,
- "warehouse_id": 0,
- "warehouse_name": "string"
}
]
}Позволяет изменить цену одного или нескольких товаров.
Цену каждого товара можно обновлять не больше 10 раз в час.
Чтобы сбросить old_price, поставьте 0 у этого параметра.
Если у товара установлена минимальная цена и включено автоприменение в акции, отключите его и обновите
минимальную цену, иначе вернётся ошибка action_price_enabled_min_price_missing.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects <= 1000 items Информация о ценах товаров. |
Array of objects Результаты запроса. | |||||||||
Array ()
| |||||||||
{- "prices": [
- {
- "auto_action_enabled": "UNKNOWN",
- "currency_code": "RUB",
- "min_price": "800",
- "min_price_for_auto_actions_enabled": true,
- "offer_id": "",
- "old_price": "0",
- "price": "1448",
- "price_strategy_enabled": "UNKNOWN",
- "product_id": 1386,
- "quant_size": 1,
- "vat": "0.1"
}
]
}{- "result": [
- {
- "product_id": 1386,
- "offer_id": "PH8865",
- "updated": true,
- "errors": [ ]
}
]
}В запросе вы можете передать максимум 1000 товаров.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по товарам. | |
| last_id | string Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
| limit | integer <int32> Количество значений на странице. Минимум — 1, максимум — 1000. |
object Результаты запроса. | |||||||
| |||||||
{- "filter": {
- "offer_id": [
- "356792"
], - "product_id": [
- "243686911"
], - "visibility": "ALL"
}, - "last_id": "",
- "limit": 100
}{- "result": {
- "items": [
- {
- "acquiring": 0,
- "product_id": 243686911,
- "offer_id": "356792",
- "price": {
- "currency_code": "RUB",
- "price": "499.0000",
- "old_price": "579.0000",
- "retail_price": "",
- "vat": "0.200000",
- "min_ozon_price": "",
- "marketing_price": "",
- "marketing_seller_price": "",
- "auto_action_enabled": true
}, - "price_indexes": {
- "external_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}, - "ozon_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}, - "price_index": "WITHOUT_INDEX",
- "self_marketplaces_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}
}, - "commissions": {
- "sales_percent": 15,
- "sales_percent_fbo": 15,
- "sales_percent_fbs": 0,
- "fbo_fulfillment_amount": 0,
- "fbo_direct_flow_trans_min_amount": 31,
- "fbo_direct_flow_trans_max_amount": 46.5,
- "fbo_deliv_to_customer_amount": 14.75,
- "fbo_return_flow_amount": 50,
- "fbo_return_flow_trans_min_amount": 21.7,
- "fbo_return_flow_trans_max_amount": 21.7,
- "fbs_first_mile_min_amount": 0,
- "fbs_first_mile_max_amount": 25,
- "fbs_direct_flow_trans_min_amount": 41,
- "fbs_direct_flow_trans_max_amount": 61.5,
- "fbs_deliv_to_customer_amount": 60,
- "fbs_return_flow_amount": 40,
- "fbs_return_flow_trans_min_amount": 41,
- "fbs_return_flow_trans_max_amount": 61.5
}, - "marketing_actions": null,
- "volume_weight": 0
}
], - "total": 1,
- "last_id": "ceVуbA=="
}
}Метод для получения информации о состоянии и дефектах уценённого товара по его SKU. Также метод возвращает SKU основного товара.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| discounted_skus | Array of strings <int64> Список SKU уценённых товаров. |
Array of objects Информация об уценке и основном товаре. | |||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||
{- "discounted_skus": [
- "635548518"
]
}{- "items": [
- {
- "discounted_sku": 635548518,
- "sku": 320067758,
- "condition_estimation": "4",
- "packaging_violation": "",
- "warranty_type": "",
- "reason_damaged": "Механическое повреждение",
- "comment_reason_damaged": "повреждена заводская упаковка",
- "defects": "",
- "mechanical_damage": "",
- "package_damage": "",
- "shortage": "",
- "repair": "",
- "condition": ""
}
]
}Метод для установки размера скидки на уценённые товары, продающиеся по схеме FBS.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| discount | integer <int32> Размер скидки: от 3 до 99 процентов. |
| product_id | integer <int64> Идентификатор товара. |
| result | boolean Результат работы метода. |
{- "discount": 0,
- "product_id": 0
}{- "result": true
}Для продвижения товаров участвуйте в акциях, которые Ozon проводит для покупателей. Подробнее об акциях в Базе знаний продавца.
Метод для получения списка акций, в которых можно участвовать.
Array of objects Результаты запроса. | |||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||
{- "result": [
- {
- "id": 71342,
- "title": "test voucher #2",
- "date_start": "2021-11-22T09:46:38Z",
- "date_end": "2021-11-30T20:59:59Z",
- "potential_products_count": 0,
- "is_participating": true,
- "participating_products_count": 5,
- "description": "",
- "action_type": "DISCOUNT",
- "banned_products_count": 0,
- "with_targeting": false,
- "discount_type": "UNKNOWN",
- "discount_value": 0,
- "order_amount": 0,
- "freeze_date": "",
- "is_voucher_action": true
}
]
}Метод для получения списка товаров, которые могут участвовать в акции, по её идентификатору.
| action_id | number <double> Идентификатор акции. |
| limit | number <double> Количество ответов на странице. По умолчанию — 100. |
| offset | number <double> Количество элементов, которое будет пропущено в ответе. Например, если |
object Результаты запроса. | |||||
| |||||
{- "action_id": 63337,
- "limit": 10,
- "offset": 0
}{- "result": {
- "products": [
- {
- "id": 226,
- "price": 250,
- "action_price": 0,
- "max_action_price": 175,
- "add_mode": "NOT_SET",
- "stock": 0,
- "min_stock": 0
}, - {
- "id": 1366,
- "price": 2300,
- "action_price": 630,
- "max_action_price": 770,
- "add_mode": "MANUAL",
- "stock": 0,
- "min_stock": 0
}
], - "total": 2
}
}Метод для получения списка товаров, участвующих в акции, по её идентификатору.
| action_id | number <double> Идентификатор акции. |
| limit | number <double> Количество ответов на странице. По умолчанию — 100. |
| offset | number <double> Количество элементов, которое будет пропущено в ответе. Например, если |
object Результаты запроса. | |||||
| |||||
{- "action_id": 66011,
- "limit": 10,
- "offset": 0
}{- "result": {
- "products": [
- {
- "id": 1383,
- "price": 5503,
- "action_price": 621,
- "max_action_price": 3712.1,
- "add_mode": "MANUAL",
- "stock": 0,
- "min_stock": 0
}
], - "total": 1
}
}Метод для добавления товаров в доступную акцию.
| action_id | number <double> Идентификатор акции. |
Array of objects Список товаров. |
object Результаты запроса. | |||||
| |||||
{- "action_id": 60564,
- "products": [
- {
- "action_price": 356,
- "product_id": 1389,
- "stock": 10
}
]
}{- "result": {
- "product_ids": [
- 1389
], - "rejected": [ ]
}
}Метод для удаления товаров из акции.
| action_id | number <double> Идентификатор акции. |
| product_ids | Array of numbers <double> Список идентификаторов товаров. |
object Результаты запроса. | |||||
| |||||
{- "action_id": 66011,
- "product_ids": [
- 14975
]
}{- "result": {
- "product_ids": [
- 14975
], - "rejected": [ ]
}
}Array of objects Результат работы метода. | |||||||||||||||
Array ()
| |||||||||||||||
{ }{- "result": [
- {
- "date_end": "string",
- "date_start": "string",
- "description": "string",
- "freeze_date": "string",
- "hotsale_id": 0,
- "is_participating": true,
- "title": "string"
}
]
}Метод для получения списка товаров, которые могут участвовать или уже участвуют в акции Hot Sale.
| hotsale_id | number <double> Идентификатор акции Hot Sale. |
| limit | number <double> Количество элементов в ответе. По умолчанию — 100. |
| offset | number <double> Количество элементов, которое будет пропущено в ответе. Например, если |
object Результат работы метода. | |||||
| |||||
{- "hotsale_id": 0,
- "limit": 0,
- "offset": 0
}{- "result": {
- "products": [
- {
- "action_price": 0,
- "date_day_promo": "string",
- "id": 0,
- "is_active": true,
- "max_action_price": 0,
- "min_stock": 0,
- "stock": 0
}
], - "total": 0
}
}| hotsale_id | number <double> Идентификатор акции Hot Sale. |
Array of objects Товары, которые нужно добавить в акцию. Максимальное количество в одном запросе — 100. |
object Результат работы метода. | |||
| |||
{- "hotsale_id": 0,
- "products": [
- {
- "action_price": 0,
- "product_id": 0,
- "stock": 0
}
]
}{- "result": {
- "rejected": [
- {
- "product_id": 0,
- "reason": "string"
}
]
}
}| hotsale_id | number <double> Идентификатор акции Hot Sale. |
| product_ids | Array of numbers <double> Список идентификаторов товаров. Максимальное количество в одном запросе — 100. |
object Результат работы метода. | |||
| |||
{- "hotsale_id": 0,
- "product_ids": [
- 0
]
}{- "result": {
- "rejected": [
- {
- "product_id": 0,
- "reason": "string"
}
]
}
}Метод для получения списка товаров, которые покупатели хотят купить со скидкой.
| status | string Default: "UNKNOWN" Enum: "NEW" "SEEN" "APPROVED" "PARTLY_APPROVED" "DECLINED" "AUTO_DECLINED" "DECLINED_BY_USER" "COUPON" "PURCHASED" Статус заявки на скидку:
|
| page | integer <uint64> Страница, с которой нужно выгрузить список заявок на скидку. |
| limit | integer <uint64> Максимальное количество заявок на странице. |
Array of objects Список заявок. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{- "status": "UNKNOWN",
- "page": 0,
- "limit": 0
}{- "result": [
- {
- "id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "end_at": "2019-08-24T14:15:22Z",
- "edited_till": "2019-08-24T14:15:22Z",
- "status": "string",
- "customer_name": "string",
- "sku": 0,
- "user_comment": "string",
- "seller_comment": "string",
- "requested_price": 0,
- "approved_price": 0,
- "original_price": 0,
- "discount": 0,
- "discount_percent": 0,
- "base_price": 0,
- "min_auto_price": 0,
- "prev_task_id": 0,
- "is_damaged": true,
- "moderated_at": "2019-08-24T14:15:22Z",
- "approved_discount": 0,
- "approved_discount_percent": 0,
- "is_purchased": true,
- "is_auto_moderated": true,
- "offer_id": "string",
- "email": "string",
- "last_name": "string",
- "first_name": "string",
- "patronymic": "string",
- "approved_quantity_min": 0,
- "approved_quantity_max": 0,
- "requested_quantity_min": 0,
- "requested_quantity_max": 0,
- "requested_price_with_fee": 0,
- "approved_price_with_fee": 0,
- "approved_price_fee_percent": 0
}
]
}Вы можете согласовывать заявки в статусах: NEW — новые, SEEN — просмотренные.
Array of objects Список заявок. |
object Результат работы метода. | |||||||
| |||||||
{- "tasks": [
- {
- "id": 0,
- "approved_price": 0,
- "seller_comment": "string",
- "approved_quantity_min": 0,
- "approved_quantity_max": 0
}
]
}{- "result": {
- "fail_details": [
- {
- "task_id": 0,
- "error_for_user": "string"
}
], - "success_count": 0,
- "fail_count": 0
}
}Вы можете отклонить заявки в статусах: NEW — новые, SEEN — просмотренные.
Array of objects Список заявок. |
object Результат работы метода. | |||||||
| |||||||
{- "tasks": [
- {
- "id": 0,
- "seller_comment": "string"
}
]
}{- "result": {
- "fail_details": [
- {
- "task_id": 0,
- "error_for_user": "string"
}
], - "success_count": 0,
- "fail_count": 0
}
}Метод для получения списка конкурентов — продавцов с похожими товарами в других интернет-магазинах и маркетплейсах.
| page | integer <int64> Страница списка, с которой нужно выгрузить конкурентов. Минимальное значение — |
| limit | integer <int64> Максимальное количество конкурентов на странице. Допустимы значения от |
Array of objects Список конкурентов. | |
| total | integer <int32> Общее количество конкурентов. |
{- "page": 1,
- "limit": 20
}{- "competitor": [
- {
- "competitor_name": "string",
- "competitor_id": 0
}
], - "total": 0
}| page | integer <int64> Страница списка, с которой нужно выгрузить стратегии. Минимальное значение — |
| limit | integer <int64> Максимальное количество стратегий на странице. Допустимые значения — от |
Array of objects Список стратегий. | |
| total | integer <int32> Общее количество стратегий. |
{- "page": 1,
- "limit": 20
}{- "strategies": [
- {
- "strategy_id": "string",
- "strategy_name": "string",
- "type": "string",
- "update_type": "string",
- "updated_at": "string",
- "products_count": 0,
- "competitors_count": 0,
- "enabled": true
}
], - "total": 0
}Array of objects Список конкурентов. | |
| strategy_name | string Название стратегии. |
object Результат работы метода. | |||
| |||
{- "strategy_name": "Новая стратегия",
- "competitors": [
- {
- "competitor_id": 1008426,
- "coefficient": 1
}, - {
- "competitor_id": 204,
- "coefficient": 1
}, - {
- "competitor_id": 91,
- "coefficient": 1
}, - {
- "competitor_id": 48,
- "coefficient": 1
}
], - "company_id": 7
}{- "result": {
- "id": "4f3a1d4c-5833-4f04-b69b-495cbc1f6f1c"
}
}| strategy_id | string Идентификатор стратегии. |
object Результат работы метода. | |||||||||||
| |||||||||||
{- "strategy_id": "string"
}{- "result": {
- "strategy_name": "тест1",
- "enabled": true,
- "update_type": "strategyItemsListChanged",
- "type": "COMP_PRICE",
- "competitors": [
- {
- "competitor_id": 204,
- "coefficient": 1
}, - {
- "competitor_id": 1008426,
- "coefficient": 1
}
]
}
}Можно обновить все стратегии кроме системной.
Array of objects Список конкурентов. | |
| strategy_id | string Идентификатор стратегии. |
| strategy_name | string Название стратегии. |
{- "strategy_id": "a3de1826-9c54-40f1-bb6d-1a9e2638b058",
- "strategy_name": "Новая стратегия",
- "competitors": [
- {
- "competitor_id": 1008426,
- "coefficient": 1
}, - {
- "competitor_id": 204,
- "coefficient": 1
}, - {
- "competitor_id": 91,
- "coefficient": 1
}, - {
- "competitor_id": 48,
- "coefficient": 1
}, - {
- "id": 45,
- "coefficient": 1
}
]
}{ }| product_id | Array of strings <int64> Список идентификаторов товаров. Максимальное количество — 50. |
| strategy_id | string Идентификатор стратегии. |
object Результат работы метода. | |||||
| |||||
{- "product_id": [
- "29209"
], - "strategy_id": "e29114f0-177d-4160-8d06-2bc528470dda"
}{- "result": {
- "failed_product_count": 0
}
}| product_id | Array of strings <int64> Список идентификаторов товаров. Максимальное количество — 50. |
object Результат работы метода. | |||
| |||
{- "product_id": [
- "string"
]
}{- "result": {
- "products_info": [
- {
- "product_id": 29209,
- "strategy_id": "b7cd30e6-5667-424d-b105-fbec30a52477"
}
]
}
}| strategy_id | string Идентификатор стратегии. |
object Список товаров. | |||
| |||
{- "strategy_id": "string"
}{- "result": {
- "product_id": [
- "string"
]
}
}Если вы добавили товар в стратегию ценообразования, метод вернёт цену и ссылку на товар у конкурента.
| product_id | integer <int64> Идентификатор товара. |
object Результат работы метода. | |||||||||||||
| |||||||||||||
{- "product_id": 0
}{- "result": {
- "strategy_id": "string",
- "is_enabled": true,
- "strategy_product_price": 0,
- "price_downloaded_at": "2022-11-17T15:33:53.936Z",
- "strategy_competitor_id": 0,
- "strategy_competitor_product_url": "string"
}
}| product_id | Array of strings <int64> Список идентификаторов товаров. Максимальное количество — 50. |
object Результат работы метода. | |||
| |||
{- "product_id": [
- "string"
]
}{- "result": {
- "failed_product_count": 0
}
}Можно изменить статус любой стратегии кроме системной.
| enabled | boolean Статус стратегии:
|
| strategy_id | string Идентификатор стратегии. |
{- "strategy_id": "c7516438-7124-4e2c-85d3-ccd92b6b9b65",
- "enabled": true
}{ }Можно удалить любую стратегию кроме системной.
| strategy_id | string Идентификатор стратегии. |
{- "strategy_id": "string"
}{ }Метод для получения списка брендов, для которых требуется предоставить сертификат. Ответ содержит список брендов, товары которых есть в вашем личном кабинете.
Список брендов может изменяться, если Ozon получит требование от бренда предоставлять сертификат.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| page | integer <int32> Номер страницы, возвращаемой в запросе. |
| page_size | integer <int32> Количество элементов на странице. |
object Результат запроса. | |||||
| |||||
{- "page": 0,
- "page_size": 0
}{- "result": {
- "brand_certification": [
- {
- "brand_id": 135476863,
- "brand_name": "Sea of Spa",
- "has_certificate": false
}
], - "total": 1
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Список типов и названий сертификатов. | |||||
Array ()
| |||||
{- "result": [
- {
- "name": "ГОСТ",
- "value": "gost"
}, - {
- "name": "Технический регламент РФ",
- "value": "technical_regulations_rf"
}, - {
- "name": "Технический регламент ТС",
- "value": "technical_regulations_cu"
}
]
}object Список типов соответствия требованиям. | |||||
| |||||
{- "result": {
- "base": [
- {
- "code": "string",
- "title": "string"
}
], - "hazard": [
- {
- "code": "string",
- "title": "string"
}
]
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Список типов и названий сертификатов. | |||||
Array ()
| |||||
{- "result": [
- {
- "name": "Сертификат соответствия",
- "value": "certificate_of_conformity"
}, - {
- "name": "Декларация",
- "value": "declaration"
}, - {
- "name": "Свидетельство о гос регистрации",
- "value": "certificate_of_registration"
}, - {
- "name": "Регистрационное удостоверение",
- "value": "registration_certificate"
}, - {
- "name": "Отказное письмо",
- "value": "refused_letter"
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| page | integer <int32> Номер страницы, возвращаемой в запросе. |
| page_size | integer <int32> Количество элементов на странице. |
object Результат запроса. | |||||
| |||||
{- "page": 1,
- "page_size": 100
}{- "result": {
- "certification": [
- {
- "is_required": true,
- "category_name": "Витаминно-минеральные комплексы для взрослых"
}
], - "total": 1
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| files required | Array of file Массив сертификатов для товара. Допустимые расширения jpg, jpeg, png, pdf. |
| name required | string Название сертификата. Максимум 100 символов. |
| number required | string Номер сертификата. Максимум 100 символов. |
| type_code required | string Enum: "certificate_of_conformity" "declaration" "certificate_of_registration" "registration_certificate" "refused_letter" Тип сертификата. Чтобы получить доступные типы, используйте метод GET /v1/product/certificate/types. |
| accordance_type_code | string Enum: "technical_regulations_rf" "technical_regulations_cu" "gost" Тип соответствия требованиям. Чтобы получить доступные типы, используйте метод GET /v1/product/certificate/accordance-types. |
| issue_date required | string <date-time> Default: "2021-04-30T11:31:26Z" Дата начала действия сертификата. |
| expire_date | string <date-time> Дата окончания действия сертификата. Может быть пустым для бессрочных сертификатов. Формат: |
{- "id": 50058
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| certificate_id | integer <int64> Идентификатор сертификата, который был присвоен при его загрузке. |
| product_id | Array of integers <int64> Массив идентификаторов товаров, к которым относится этот сертификат. |
| result | boolean Результат обработки запроса. |
{- "certificate_id": 50058,
- "product_id": [
- 290
]
}{- "result": true
}| certificate_id required | integer <int32> Идентификатор сертификата. |
object Результат удаления сертификата. | |||||
| |||||
{- "certificate_id": 0
}{- "result": {
- "is_delete": true,
- "error_message": "string"
}
}| certificate_number required | string Идентификатор сертификата. |
object Информация о сертификате. | |||||||||||||||||||||||
| |||||||||||||||||||||||
{- "certificate_number": "string"
}{- "result": {
- "certificate_id": 0,
- "certificate_number": "string",
- "certificate_name": "string",
- "type_code": "string",
- "status_code": "string",
- "accordance_type_code": "string",
- "rejection_reason_code": "string",
- "verification_comment": "string",
- "issue_date": "2019-08-24T14:15:22Z",
- "expire_date": "2019-08-24T14:15:22Z",
- "products_count": 0
}
}| offer_id | string Артикул товара, привязанного к сертификату. Передайте параметр, если нужны сертификаты, к которым привязаны определённые товары. |
| status | string Статус сертификата. Передайте параметр, если нужны сертификаты с определённым статусом. |
| type | string Тип сертификата. Передайте параметр, если нужны сертификаты с определённым типом. |
| page required | integer <int32> Страница, с которой следует выводить список. Минимальное значение — 1. |
| page_size required | integer <int32> Количество объектов на странице. Значение — от 1 до 1000. |
object Список сертификатов. | |||||
| |||||
{- "offer_id": "string",
- "status": "string",
- "type": "string",
- "page": 0,
- "page_size": 0
}{- "result": {
- "certificates": [
- {
- "certificate_id": 0,
- "certificate_number": "string",
- "certificate_name": "string",
- "type_code": "string",
- "status_code": "string",
- "accordance_type_code": "string",
- "rejection_reason_code": "string",
- "verification_comment": "string",
- "issue_date": "2019-08-24T14:15:22Z",
- "expire_date": "2019-08-24T14:15:22Z",
- "products_count": 0
}
], - "page_count": 0
}
}Метод для получения списка возможных статусов товаров при их привязке к сертификату.
Array of objects Список статусов товаров. | |||||
Array ()
| |||||
{ }{- "result": [
- {
- "code": "string",
- "name": "string"
}
]
}| certificate_id required | integer <int32> Идентификатор сертификата. |
| product_status_code | string Статус проверки товара при привязке к сертификату. |
| page required | integer <int32> Номер страницы, с которой выводить список. Минимальное значение — 1. |
| page_size required | integer <int32> Количество объектов на странице. Значение — от 1 до 1000. |
object Товары, привязанные к сертификату. | |||||
| |||||
{- "certificate_id": 0,
- "product_status_code": "string",
- "page": 0,
- "page_size": 0
}{- "result": {
- "items": [
- {
- "product_id": 0,
- "product_status_code": "string"
}
], - "count": 0
}
}| certificate_id required | integer <int32> Идентификатор сертификата. |
| product_id required | Array of strings <int64> Список идентификаторов товара, которые нужно отвязать от сертификата. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "certificate_id": 0,
- "product_id": [
- "string"
]
}{- "result": [
- {
- "error": "string",
- "product_id": 0,
- "updated": true
}
]
}Array of objects Причины отклонения сертификата. | |||||
Array ()
| |||||
{ }{- "result": [
- {
- "code": "string",
- "name": "string"
}
]
}Array of objects Список возможных статусов сертификатов. | |||||
Array ()
| |||||
{ }{- "result": [
- {
- "code": "string",
- "name": "string"
}
]
}В запросе не нужно указывать параметры. Ваша компания будет определена по Client-ID.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Список складов. | |||||||||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||||||||
{- "result": [
- {
- "has_entrusted_acceptance": true,
- "is_rfbs": true,
- "name": "string",
- "warehouse_id": 0,
- "can_print_act_in_advance": true,
- "first_mile_type": {
- "dropoff_point_id": "string",
- "dropoff_timeslot_id": 0,
- "first_mile_is_changing": true,
- "first_mile_type": "DropOff"
}, - "has_postings_limit": true,
- "is_karantin": true,
- "is_kgt": true,
- "is_economy": true,
- "is_timetable_editable": true,
- "min_postings_limit": 0,
- "postings_limit": 0,
- "min_working_days": 0,
- "status": "string",
- "working_days": [
- "1"
]
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр для поиска методов доставки. | |
| limit | integer <int64> Количество элементов в ответе. Максимум — 50, минимум — 1. |
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
| has_next | boolean Признак, что в запросе вернулась только часть методов доставки:
| ||||||||||||||||||||||
Array of objects Результат запроса. | |||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||
{- "filter": {
- "provider_id": 0,
- "status": "",
- "warehouse_id": 15588127982000
}, - "limit": 100,
- "offset": 0
}{- "result": [
- {
- "id": 15588127982000,
- "company_id": 1,
- "name": "Ozon Логистика курьеру, Есипово",
- "status": "ACTIVE",
- "cutoff": "13:00",
- "provider_id": 24,
- "template_id": 0,
- "warehouse_id": 15588127982000,
- "created_at": "2019-04-04T15:22:31.048202Z",
- "updated_at": "2021-08-15T10:21:44.854209Z",
- "sla_cut_in": 1440
}
], - "has_next": false
}Возвращает список необработанных отправлений за указанный период времени — он должен быть не больше одного года.
Возможные статусы отправлений:
awaiting_registration — ожидает регистрации,acceptance_in_progress — идёт приёмка,awaiting_approve — ожидает подтверждения,awaiting_packaging — ожидает упаковки,awaiting_deliver — ожидает отгрузки,arbitration — арбитраж,client_arbitration — клиентский арбитраж доставки,delivering — доставляется,driver_pickup — у водителя,cancelled — отменено,not_accepted — не принят на сортировочном центре,sent_by_seller — отправлено продавцом.Чтобы получать актуальную дату отгрузки, регулярно обновляйте информацию об отправлениях или подключите пуш-уведомления.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| dir | string Направление сортировки:
|
object Фильтр запроса. Используйте фильтр либо по времени сборки — Чтобы использовать фильтр по времени сборки, заполните поля Чтобы использовать фильтр по дате передачи отправления в доставку, заполните поля | |
| limit | integer <int64> Количество значений в ответе:
|
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
object Дополнительные поля, которые нужно добавить в ответ. |
object Результат запроса. | |||||
| |||||
{- "dir": "ASC",
- "filter": {
- "cutoff_from": "2021-08-24T14:15:22Z",
- "cutoff_to": "2021-08-31T14:15:22Z",
- "delivery_method_id": [ ],
- "is_quantum": false,
- "provider_id": [ ],
- "status": "awaiting_packaging",
- "warehouse_id": [ ]
}, - "limit": 100,
- "offset": 0,
- "with": {
- "analytics_data": true,
- "barcodes": true,
- "financial_data": true,
- "translit": true
}
}{- "result": {
- "postings": [
- {
- "posting_number": "23713478-0018-3",
- "order_id": 559293114,
- "order_number": "33713378-0051",
- "pickup_code_verified_at": "2025-01-17T11:03:00.124Z",
- "status": "awaiting_packaging",
- "delivery_method": {
- "id": 15110442724000,
- "name": "Ozon Логистика курьеру, Москва",
- "warehouse_id": 15110442724000,
- "warehouse": "Склад на Ленина",
- "tpl_provider_id": 24,
- "tpl_provider": "Ozon Логистика"
}, - "tracking_number": "",
- "tpl_integration_type": "ozon",
- "in_process_at": "2021-08-25T10:48:38Z",
- "shipment_date": "2021-08-26T10:00:00Z",
- "delivering_date": null,
- "cancellation": {
- "cancel_reason_id": 0,
- "cancel_reason": "",
- "cancellation_type": "",
- "cancelled_after_ship": false,
- "affect_cancellation_rating": false,
- "cancellation_initiator": ""
}, - "customer": null,
- "quantum_id": 0,
- "products": [
- {
- "price": "1259",
- "currency_code": "RUB",
- "offer_id": "УТ-0001365",
- "name": "Мяч, цвет: черный, 5 кг",
- "sku": 140048123,
- "quantity": 1,
- "products_requiring_jw_uin": "0",
- "mandatory_mark": [ ]
}
], - "addressee": null,
- "barcodes": {
- "upper_barcode": "%101%806044518",
- "lower_barcode": "23024930500000"
}, - "analytics_data": {
- "region": "Санкт-Петербург",
- "city": "Санкт-Петербург",
- "delivery_type": "PVZ",
- "is_premium": false,
- "payment_type_group_name": "Карты оплаты",
- "warehouse_id": 15110442724000,
- "warehouse": "Склад на Ленина",
- "tpl_provider_id": 24,
- "tpl_provider": "Ozon Логистика",
- "delivery_date_begin": "2022-08-28T14:00:00Z",
- "delivery_date_end": "2022-08-28T18:00:00Z",
- "is_legal": false
}, - "financial_data": {
- "products": [
- {
- "commission_amount": 0,
- "commission_percent": 0,
- "payout": 0,
- "product_id": 140048123,
- "old_price": 1888,
- "price": 1259,
- "total_discount_value": 629,
- "total_discount_percent": 33.32,
- "actions": [
- "Системная виртуальная скидка селлера"
], - "picking": null,
- "quantity": 1,
- "client_price": "",
- "item_services": {
- "marketplace_service_item_fulfillment": 0,
- "marketplace_service_item_pickup": 0,
- "marketplace_service_item_dropoff_pvz": 0,
- "marketplace_service_item_dropoff_sc": 0,
- "marketplace_service_item_dropoff_ff": 0,
- "marketplace_service_item_direct_flow_trans": 0,
- "marketplace_service_item_return_flow_trans": 0,
- "marketplace_service_item_deliv_to_customer": 0,
- "marketplace_service_item_return_not_deliv_to_customer": 0,
- "marketplace_service_item_return_part_goods_customer": 0,
- "marketplace_service_item_return_after_deliv_to_customer": 0
}
}
], - "posting_services": {
- "marketplace_service_item_fulfillment": 0,
- "marketplace_service_item_pickup": 0,
- "marketplace_service_item_dropoff_pvz": 0,
- "marketplace_service_item_dropoff_sc": 0,
- "marketplace_service_item_dropoff_ff": 0,
- "marketplace_service_item_direct_flow_trans": 0,
- "marketplace_service_item_return_flow_trans": 0,
- "marketplace_service_item_deliv_to_customer": 0,
- "marketplace_service_item_return_not_deliv_to_customer": 0,
- "marketplace_service_item_return_part_goods_customer": 0,
- "marketplace_service_item_return_after_deliv_to_customer": 0
}
}, - "is_express": false,
- "requirements": {
- "products_requiring_gtd": [ ],
- "products_requiring_country": [ ],
- "products_requiring_jwn": [ ]
}, - "tariffication": [
- {
- "current_tariff_rate": 0,
- "current_tariff_type": "",
- "current_tariff_charge": "",
- "current_tariff_charge_currency_code": "",
- "next_tariff_rate": 0,
- "next_tariff_type": "",
- "next_tariff_charge": "",
- "next_tariff_starts_at": "2023-11-13T08:05:57.657Z",
- "next_tariff_charge_currency_code": ""
}
]
}
], - "count": 55
}
}Возвращает список отправлений за указанный период времени — он должен быть не больше одного года.
Дополнительно можно отфильтровать отправления по их статусу — список доступных для выдачи статусов указан в описании параметра filter.status.
has_next = true в ответе может значить, что вернули не весь массив отправлений. Чтобы получить информацию об остальных отправлениях, сделайте новый запрос с другим значением offset.
Чтобы получать актуальную дату отгрузки, регулярно обновляйте информацию об отправлениях или подключите пуш-уведомления.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| dir | string Направление сортировки:
|
object Фильтр. | |
| limit | integer <int64> Количество значений в ответе:
|
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
object Дополнительные поля, которые нужно добавить в ответ. |
object Массив отправлений. | |||||
| |||||
{- "dir": "ASC",
- "filter": {
- "delivery_method_id": [
- "string"
], - "is_quantum": false,
- "last_changed_status_date": {
- "from": "2023-11-03T11:47:39.878Z",
- "to": "2023-11-03T11:47:39.878Z"
}, - "order_id": 0,
- "provider_id": [
- "string"
], - "since": "2023-11-03T11:47:39.878Z",
- "status": "awaiting_packaging",
- "to": "2023-11-03T11:47:39.878Z",
- "warehouse_id": [
- "string"
]
}, - "limit": 0,
- "offset": 0,
- "with": {
- "analytics_data": true,
- "barcodes": true,
- "financial_data": true,
- "translit": true
}
}{- "result": {
- "postings": [
- {
- "posting_number": "05708065-0029-1",
- "order_id": 680420041,
- "order_number": "05708065-0029",
- "pickup_code_verified_at": "2025-01-17T10:59:26.614Z",
- "status": "awaiting_deliver",
- "substatus": "posting_awaiting_passport_data",
- "delivery_method": {
- "id": 21321684811000,
- "name": "Ozon Логистика самостоятельно, Красногорск",
- "warehouse_id": 21321684811000,
- "warehouse": "Стим Тойс Нахабино",
- "tpl_provider_id": 24,
- "tpl_provider": "Ozon Логистика"
}, - "tracking_number": "",
- "tpl_integration_type": "ozon",
- "in_process_at": "2022-05-13T07:07:32Z",
- "shipment_date": "2022-05-13T10:00:00Z",
- "delivering_date": null,
- "cancellation": {
- "cancel_reason_id": 0,
- "cancel_reason": "",
- "cancellation_type": "",
- "cancelled_after_ship": false,
- "affect_cancellation_rating": false,
- "cancellation_initiator": ""
}, - "customer": null,
- "products": [
- {
- "price": "1390.000000",
- "currency_code": "RUB",
- "offer_id": "205953",
- "name": " Электронный конструктор PinLab Позитроник",
- "sku": 358924380,
- "quantity": 1,
- "mandatory_mark": [ ]
}
], - "addressee": null,
- "barcodes": null,
- "analytics_data": null,
- "financial_data": null,
- "is_express": false,
- "quantum_id": 0,
- "requirements": {
- "products_requiring_gtd": [ ],
- "products_requiring_country": [ ],
- "products_requiring_mandatory_mark": [ ],
- "products_requiring_jwn": [ ]
}, - "tariffication": [
- {
- "current_tariff_rate": 0,
- "current_tariff_type": "",
- "current_tariff_charge": "",
- "current_tariff_charge_currency_code": "",
- "next_tariff_rate": 0,
- "next_tariff_type": "",
- "next_tariff_charge": "",
- "next_tariff_starts_at": "2023-11-13T08:05:57.657Z",
- "next_tariff_charge_currency_code": ""
}
]
}
], - "has_next": true
}
}Чтобы получать актуальную дату отгрузки, регулярно обновляйте информацию об отправлениях или подключите пуш-уведомления.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Идентификатор отправления. |
object Дополнительные поля, которые нужно добавить в ответ. |
object Информация об отправлении. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{- "posting_number": "57195475-0050-3",
- "with": {
- "analytics_data": false,
- "barcodes": false,
- "financial_data": false,
- "product_exemplars": false,
- "translit": false
}
}{- "result": {
- "posting_number": "57195475-0050-3",
- "order_id": 438764970,
- "order_number": "57195475-0050",
- "pickup_code_verified_at": "2025-01-17T11:04:59.958Z",
- "status": "awaiting_packaging",
- "substatus": "posting_awaiting_passport_data",
- "delivery_method": {
- "id": 18114520187000,
- "name": "Ozon Логистика самостоятельно, Москва",
- "warehouse_id": 18114520187000,
- "warehouse": "Москва основной",
- "tpl_provider_id": 24,
- "tpl_provider": "Ozon Логистика"
}, - "tracking_number": "",
- "tpl_integration_type": "ozon",
- "in_process_at": "2021-11-20T09:14:16Z",
- "shipment_date": "2021-11-23T10:00:00Z",
- "delivering_date": null,
- "provider_status": "",
- "delivery_price": "",
- "cancellation": {
- "cancel_reason_id": 0,
- "cancel_reason": "",
- "cancellation_type": "",
- "cancelled_after_ship": false,
- "affect_cancellation_rating": false,
- "cancellation_initiator": ""
}, - "customer": null,
- "addressee": null,
- "products": [
- {
- "currency_code": "RUB",
- "price": "279.0000",
- "offer_id": "250-7898-1",
- "name": "Кофе ароматизированный \"Шоколадный апельсин\" 250 гр",
- "sku": 180550365,
- "quantity": 1,
- "jw_uin": [ ],
- "mandatory_mark": [ ],
- "dimensions": {
- "height": "40.00",
- "length": "240.00",
- "weight": "260",
- "width": "140.00"
}
}
], - "barcodes": null,
- "analytics_data": null,
- "financial_data": null,
- "additional_data": [ ],
- "is_express": false,
- "requirements": {
- "products_requiring_gtd": [ ],
- "products_requiring_country": [ ],
- "products_requiring_jwn": [ ]
}, - "product_exemplars": null,
- "tariffication": [
- {
- "current_tariff_rate": 0,
- "current_tariff_type": "",
- "current_tariff_charge": "",
- "current_tariff_charge_currency_code": "",
- "next_tariff_rate": 0,
- "next_tariff_type": "",
- "next_tariff_charge": "",
- "next_tariff_starts_at": "2023-11-13T08:05:57.657Z",
- "next_tariff_charge_currency_code": ""
}
]
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| barcode | string Штрихкод отправления. |
object Результаты запроса. | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
{- "barcode": "20325804886000"
}{- "result": {
- "posting_number": "57195475-0050-3",
- "order_id": 438764970,
- "order_number": "57195475-0050",
- "status": "awaiting_packaging",
- "delivery_method": {
- "id": 18114520187000,
- "name": "Ozon Логистика самостоятельно, Москва",
- "warehouse_id": 18114520187000,
- "warehouse": "Москва основной",
- "tpl_provider_id": 24,
- "tpl_provider": "Ozon Логистика"
}, - "tracking_number": "",
- "tpl_integration_type": "ozon",
- "in_process_at": "2021-11-20T09:14:16Z",
- "shipment_date": "2021-11-23T10:00:00Z",
- "delivering_date": null,
- "provider_status": "",
- "delivery_price": "",
- "cancellation": {
- "cancel_reason_id": 0,
- "cancel_reason": "",
- "cancellation_type": "",
- "cancelled_after_ship": false,
- "affect_cancellation_rating": false,
- "cancellation_initiator": ""
}, - "customer": null,
- "addressee": null,
- "products": [
- {
- "price": "279.0000",
- "offer_id": "250-7898-1",
- "name": "Кофе ароматизированный \"Шоколадный апельсин\" 250 гр",
- "sku": 180550365,
- "quantity": 1,
- "mandatory_mark": [ ],
- "dimensions": {
- "height": "40.00",
- "length": "240.00",
- "weight": "260",
- "width": "140.00"
}
}
], - "barcodes": null,
- "analytics_data": null,
- "financial_data": null,
- "additional_data": [ ],
- "is_express": false,
- "requirements": {
- "products_requiring_gtd": [ ],
- "products_requiring_country": [ ]
}, - "product_exemplars": null
}
}Метод для передачи количества коробок для отправлений, в которых есть многокоробочные товары.
Используйте метод при работе по схеме rFBS Агрегатор — c доставкой партнёрами Ozon.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Идентификатор многокоробочного отправления. |
| multi_box_qty | integer <int64> Количество коробок, в которые упакован товар. |
object Результат передачи количества коробок. | |||
| |||
{- "posting_number": "string",
- "multi_box_qty": 0
}{- "result": {
- "result": true
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Информация о товарах. | |
| posting_number | string Идентификатор отправления. |
| result | string Идентификатор отправления. |
{- "items": [
- {
- "sku": 1231428352,
- "weightReal": [
- 0.3
]
}
], - "posting_number": "33920158-0006-1"
}{- "result": "33920158-0006-1"
}Метод для получения списка доступных стран-изготовителей и их ISO кодов.
| name_search | string Фильтрация по строке. |
Array of objects Список стран-изготовителей и ISO коды. | |||||
Array ()
| |||||
{- "name_search": ""
}{- "result": [
- {
- "name": "Алжир",
- "country_iso_code": "DZ"
}, - {
- "name": "Ангилья",
- "country_iso_code": "AI"
}, - {
- "name": "Виргинские Острова (Великобритания)",
- "country_iso_code": "VG"
}
]
}Метод для добавления на продукт атрибута «Страна-изготовитель», если он не был указан.
| posting_number | string Номер отправления. |
| product_id | integer <int64> Идентификатор товара. |
| country_iso_code | string Двухбуквенный код добавляемой страны по стандарту ISO_3166-1. Список доступных стран-изготовителей и их ISO коды можно получить с помощью метода /v2/posting/fbs/product/country/list. |
| product_id | integer <int64> Идентификатор товара. |
| is_gtd_needed | boolean Признак того, что необходимо передать номер грузовой таможенной декларации (ГТД) для продукта и отправления. |
{- "country_iso_code": "NO",
- "posting_number": "57195475-0050-3",
- "product_id": 180550365
}{- "product_id": 180550365,
- "is_gtd_needed": true
}Метод для получения габаритных, весовых и прочих ограничений пункта приёма по номеру отправления. Метод применим только для работы по схеме FBS.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Номер отправления, для которого нужно определить ограничения. |
object | |||||||||||||||||
| |||||||||||||||||
{- "posting_number": "76673629-0020-1"
}{- "result": {
- "posting_number": "76673629-0020-1",
- "max_posting_weight": 40000,
- "min_posting_weight": 0,
- "width": 500,
- "height": 500,
- "length": 500,
- "max_posting_price": 500000,
- "min_posting_price": 0
}
}Генерирует PDF-файл с этикетками для указанных отправлений. В одном запросе можно передать не больше 20 идентификаторов. Если хотя бы для одного отправления возникнет ошибка, этикетки не будут подготовлены для всех отправлений в запросе.
Рекомендуем запрашивать этикетки через 45–60 секунд после сборки заказа.
Ошибка The next postings aren't ready означает, что этикетки ещё не готовы, повторите запрос позднее.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | Array of strings Идентификатор отправления. |
| file_content | string <byte> Содержание файла в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{- "posting_number": [
- "48173252-0034-4"
]
}{ "content_type": "application/pdf", "file_name": "ticket-170660-2023-07-13T13:17:06Z.pdf", "file_content": "%PDF-1.7\n%âãÏÓ\n53 0 obj\n<</MarkInfo<</Marked true/Type/MarkInfo>>/Pages 9 0 R/StructTreeRoot 10 0 R/Type/Catalog>>\nendobj\n8 0 obj\n<</Filter/FlateDecode/Length 2888>>\nstream\nxå[[ݶ\u0011~?¿BÏ\u0005Bs\u001c^\u0000Àwí5ú\u0010 m\u0016Èsà¦)\n;hÒ\u0014èÏïG\u0014)<{äµ] ]?¬¬oIÎ}¤F±óϤñï\u001bÕü×X´OÏï?^~¹$<ø¨È9q\u0013Y\u0012åñì§_¼|ÿégü\t+\u0012\u001bxª}Æxҿ¿¼_º¼xg¦þ5OkuÌ3ýíògüûå\"Ni\u0016C\u0001°\u000fA9g'r¢\"\u0013YóĪ\u0018NÑ{\u001dÕóZ¬\\Ô\"" }
Метод для создания задания на асинхронное формирование этикеток. Метод может вернуть несколько заданий: на формирование маленькой и большой этикетки.
Чтобы получить созданные этикетки, используйте /v1/posting/fbs/package-label/get.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | Array of strings Номера отправлений, для которых нужны этикетки. |
object Результат работы метода. | |||
| |||
{- "posting_number": [
- "4708216109137",
- "3697105098026"
]
}{- "result": {
- "tasks": [
- {
- "task_id": 5819327210248,
- "task_type": "big_label"
}, - {
- "task_id": 5819327210249,
- "task_type": "small_label"
}
]
}
}Метод для создания задания на асинхронное формирование этикеток.
Для получения этикеток, созданных в результате вызова метода, используйте /v1/posting/fbs/package-label/get.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | Array of strings Номера отправлений, для которых нужны этикетки. |
object Результат работы метода. | |||
| |||
{- "posting_number": [
- "string"
]
}{- "result": {
- "task_id": 5819327210249
}
}Метод для получения этикеток после вызова /v1/posting/fbs/package-label/create.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| task_id required | integer <int64> Номер задания на формирование этикеток из ответа метода /v1/posting/fbs/package-label/create. |
object Результат работы метода. | |||||||
| |||||||
{- "task_id": 0
}{- "result": {
- "status": "completed",
}
}Возвращает список причин отмены для конкретных отправлений.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| related_posting_numbers | Array of strings Номера отправлений. |
Array of objects Результат запроса. | |||||
Array ()
| |||||
{- "related_posting_numbers": [
- "73837363-0010-3"
]
}{- "result": [
- {
- "posting_number": "73837363-0010-3",
- "reasons": [
- {
- "id": 352,
- "title": "Товар закончился на складе продавца",
- "type_id": "seller"
}, - {
- "id": 400,
- "title": "Остался только бракованный товар",
- "type_id": "seller"
}, - {
- "id": 402,
- "title": "Другое (вина продавца)",
- "type_id": "seller"
}
]
}
]
}Возвращает список причин отмены для всех отправлений.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Результат работы метода. | |||||||||
Array ()
| |||||||||
{- "result": [
- {
- "id": 352,
- "title": "Товар закончился на складе продавца",
- "type_id": "seller",
- "is_available_for_cancellation": true
}, - {
- "id": 401,
- "title": "Продавец отклонил арбитраж",
- "type_id": "seller",
- "is_available_for_cancellation": false
}, - {
- "id": 402,
- "title": "Другое (вина продавца)",
- "type_id": "seller",
- "is_available_for_cancellation": true
}, - {
- "id": 666,
- "title": "Возврат из службы доставки: нет доставки в указанный регион",
- "type_id": "seller",
- "is_available_for_cancellation": false
}
]
}Используйте метод, если вы не можете отправить часть продуктов из отправления.
Чтобы получить идентификаторы причин отмены cancel_reason_id при работе по схемам FBS или rFBS, используйте метод /v2/posting/fbs/cancel-reason/list.
Условно-доставленные отправления отменить нельзя.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cancel_reason_id | integer <int64> Идентификатор причины отмены отправления товара. |
| cancel_reason_message | string Обязательное поле. Дополнительная информация по отмене. |
Array of objects Информация о товарах. | |
| posting_number | string Идентификатор отправления. |
| result | string Номер отправления. |
{- "cancel_reason_id": 352,
- "cancel_reason_message": "Product is out of stock",
- "items": [
- {
- "quantity": 5,
- "sku": 150587396
}
], - "posting_number": "33920113-1231-1"
}{- "result": ""
}Меняет статус отправления на cancelled.
Перед началом работы проверьте причины отмены для конкретного отправления методом /v1/posting/fbs/cancel-reason.
Условно-доставленные отправления отменить нельзя.
Если значение параметра cancel_reason_id — 402, заполните поле cancel_reason_message.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cancel_reason_id | integer <int64> Идентификатор причины отмены отправления. |
| cancel_reason_message | string Дополнительная информация по отмене. Если |
| posting_number | string Идентификатор отправления. |
| result | boolean Результат обработки запроса. |
{- "cancel_reason_id": 352,
- "cancel_reason_message": "Product is out of stock",
- "posting_number": "33920113-1231-1"
}{- "result": true
}Если отправление передано в доставку, но не просканировано в сортировочном центре, можно открыть спор. Открытый спор переведёт отправление в статус arbitration.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | Array of strings Идентификатор отправления. |
| result | boolean Результат обработки запроса. |
{- "posting_number": [
- "33920143-1195-1"
]
}{- "result": true
}Передает спорные заказы к отгрузке. Статус отправления изменится на awaiting_deliver.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | Array of strings Идентификатор отправления. |
| result | boolean Результат обработки запроса. |
{- "posting_number": [
- "33920143-1195-1"
]
}{- "result": true
}Метод позволяет проверить код курьера при передаче отправлений realFBS Express. Подробнее о передаче отправлений в Базе знаний продавца.
| pickup_code required | string Код курьера. |
| posting_number required | string Номер отправления. |
| valid | boolean
|
{- "pickup_code": "string",
- "posting_number": "string"
}{- "valid": true
}Метод для получения таможенных деклараций Elektronik Ticaret Gümrük Beyannamesi (ETGB) для продавцов из Турции.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по периоду создания деклараций. |
Array of objects Результат запроса. | |||||
Array ()
| |||||
{- "date": {
- "from": "2023-02-13T12:13:16.818Z",
- "to": "2023-02-13T12:13:16.818Z"
}
}{- "result": [
- {
- "posting_number": "string",
- "etgb": {
- "number": "string",
- "date": "string",
- "url": "string"
}
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
| limit | integer <int32> [ 1 .. 1000 ] Количество значений в ответе. |
Array of objects Список неоплаченных товаров. | |
| cursor | string Указатель для выборки следующих данных. |
{- "cursor": "hCGiPPopcBFMgMErdzaCEpzQfinuPyEhUoSmBMADuoFAhBjXeA==",
- "limit": 1000
}{- "products": [
- {
- "product_id": 145123054,
- "offer_id": "10032",
- "quantity": 1,
- "name": "Телевизор LG",
}
], - "cursor": "hCGiPPopcBFMgMErdzaCEpzQfinuPyEhUoSmBMADuoFAhBjXeA=="
}Вы можете добавить полигон к методу доставки.
Создайте полигон, получив его координаты на https://geojson.io: отметьте на карте минимум 3 точки и соедините их линиями.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| coordinates | string Координаты полигона доставки в формате |
| polygon_id | integer <int64> Идентификатор полигона. |
{- "coordinates": "[[[30.149574279785153,59.86550435303646],[30.21205902099609,59.846884387977326],[30.255661010742184,59.86240174913176],[30.149574279785153,59.86550435303646]]]"
}{- "polygonId": "1323"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_method_id | integer <int32> Идентификатор метода доставки. |
Array of objects Список полигонов. | |
object Расположение склада. |
{- "delivery_method_id": 0,
- "polygons": [
- {
- "polygon_id": "1323",
- "time": "30"
}
], - "warehouse_location": {
- "lat": "58.52391272075821",
- "lon": "31.236791610717773"
}
}{ }Возвращает список отправлений за указанный период времени.
Если период больше года, вернётся ошибка PERIOD_IS_TOO_LONG.
Дополнительно можно отфильтровать отправления по их статусу.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| dir | string Направление сортировки:
|
object Фильтр для поиска отправлений. | |
| limit | integer <int64> Количество значений в ответе:
|
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
| translit | boolean Если включена транслитерация адреса из кириллицы в латиницу — |
object Дополнительные поля, которые нужно добавить в ответ. |
Array of objects Массив отправлений. | |||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||
{- "dir": "ASC",
- "filter": {
- "since": "2021-09-01T00:00:00.000Z",
- "status": "",
- "to": "2021-11-17T10:44:12.828Z"
}, - "limit": 5,
- "offset": 0,
- "translit": true,
- "with": {
- "analytics_data": true,
- "financial_data": true
}
}{- "result": [
- {
- "order_id": 354680487,
- "order_number": "16965409-0014",
- "posting_number": "16965409-0014-1",
- "status": "delivered",
- "cancel_reason_id": 0,
- "created_at": "2021-09-01T00:23:45.607000Z",
- "in_process_at": "2021-09-01T00:25:30.120000Z",
- "products": [
- {
- "sku": 160249683,
- "name": "Так говорил Омар Хайям. Жизнеописание. Афоризмы и рубайят. Классика в словах и картинках",
- "quantity": 1,
- "offer_id": "978-5-906864-56-7",
- "price": "81.00",
- "digital_codes": [ ],
- "currency_code": "RUB"
}
], - "analytics_data": {
- "region": "",
- "city": "",
- "delivery_type": "PVZ",
- "is_premium": false,
- "payment_type_group_name": "Карты оплаты",
- "warehouse_id": 17717042026000,
- "warehouse_name": "РОСТОВ-НА-ДОНУ_РФЦ",
- "is_legal": false
}, - "financial_data": {
- "products": [
- {
- "commission_amount": 12.15,
- "commission_percent": 15,
- "payout": 68.85,
- "product_id": 160249683,
- "currency_code": "RUB",
- "old_price": 115,
- "price": 81,
- "total_discount_value": 34,
- "total_discount_percent": 29.57,
- "actions": [
- "Системная виртуальная скидка селлера"
], - "picking": null,
- "quantity": 0,
- "client_price": "",
- "item_services": {
- "marketplace_service_item_fulfillment": -31.5,
- "marketplace_service_item_pickup": 0,
- "marketplace_service_item_dropoff_pvz": 0,
- "marketplace_service_item_dropoff_sc": 0,
- "marketplace_service_item_dropoff_ff": 0,
- "marketplace_service_item_direct_flow_trans": -5,
- "marketplace_service_item_return_flow_trans": 0,
- "marketplace_service_item_deliv_to_customer": -20,
- "marketplace_service_item_return_not_deliv_to_customer": 0,
- "marketplace_service_item_return_part_goods_customer": 0,
- "marketplace_service_item_return_after_deliv_to_customer": 0
}
}
], - "posting_services": {
- "marketplace_service_item_fulfillment": 0,
- "marketplace_service_item_pickup": 0,
- "marketplace_service_item_dropoff_pvz": 0,
- "marketplace_service_item_dropoff_sc": 0,
- "marketplace_service_item_dropoff_ff": 0,
- "marketplace_service_item_direct_flow_trans": 0,
- "marketplace_service_item_return_flow_trans": 0,
- "marketplace_service_item_deliv_to_customer": 0,
- "marketplace_service_item_return_not_deliv_to_customer": 0,
- "marketplace_service_item_return_part_goods_customer": 0,
- "marketplace_service_item_return_after_deliv_to_customer": 0
}
}, - "additional_data": [ ]
}
]
}Возвращает информацию об отправлении по его идентификатору.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Номер отправления. |
| translit | boolean Если включена транслитерация адреса из кириллицы в латиницу — |
object Дополнительные поля, которые нужно добавить в ответ. |
object Результат запроса. | |||||||||||||||||||||||
| |||||||||||||||||||||||
{- "posting_number": "50520644-0012-7",
- "translit": true,
- "with": {
- "analytics_data": true,
- "financial_data": true
}
}{- "result": {
- "order_id": 354679434,
- "order_number": "50520644-0012",
- "posting_number": "50520644-0012-7",
- "status": "delivered",
- "cancel_reason_id": 0,
- "created_at": "2021-09-01T00:34:56.563Z",
- "in_process_at": "2021-09-01T00:34:56.103Z",
- "products": [
- {
- "sku": 254665483,
- "name": "Мочалка натуральная из люфы с деревянной ручкой",
- "quantity": 1,
- "offer_id": "PS1033",
- "price": "137.00",
- "digital_codes": [ ],
- "currency_code": "RUB"
}
], - "analytics_data": {
- "region": "",
- "city": "",
- "delivery_type": "Courier",
- "is_premium": false,
- "payment_type_group_name": "Карты оплаты",
- "warehouse_id": 15431806189000,
- "warehouse_name": "ХОРУГВИНО_РФЦ",
- "is_legal": false
}, - "financial_data": {
- "products": [
- {
- "commission_amount": 13.7,
- "commission_percent": 10,
- "payout": 123.3,
- "product_id": 254665483,
- "currency_code": "RUB",
- "old_price": 198,
- "price": 137,
- "total_discount_value": 61,
- "total_discount_percent": 30.81,
- "actions": [
- "Системная виртуальная скидка селлера"
], - "picking": null,
- "quantity": 0,
- "client_price": "",
- "item_services": {
- "marketplace_service_item_fulfillment": -31.5,
- "marketplace_service_item_pickup": 0,
- "marketplace_service_item_dropoff_pvz": 0,
- "marketplace_service_item_dropoff_sc": 0,
- "marketplace_service_item_dropoff_ff": 0,
- "marketplace_service_item_direct_flow_trans": -5,
- "marketplace_service_item_return_flow_trans": 0,
- "marketplace_service_item_deliv_to_customer": -20,
- "marketplace_service_item_return_not_deliv_to_customer": 0,
- "marketplace_service_item_return_part_goods_customer": 0,
- "marketplace_service_item_return_after_deliv_to_customer": 0
}
}
], - "posting_services": {
- "marketplace_service_item_fulfillment": 0,
- "marketplace_service_item_pickup": 0,
- "marketplace_service_item_dropoff_pvz": 0,
- "marketplace_service_item_dropoff_sc": 0,
- "marketplace_service_item_dropoff_ff": 0,
- "marketplace_service_item_direct_flow_trans": 0,
- "marketplace_service_item_return_flow_trans": 0,
- "marketplace_service_item_deliv_to_customer": 0,
- "marketplace_service_item_return_not_deliv_to_customer": 0,
- "marketplace_service_item_return_part_goods_customer": 0,
- "marketplace_service_item_return_after_deliv_to_customer": 0
}
}, - "additional_data": [ ]
}
}Возвращает список причин отмены для всех FBO-отправлений.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Результат работы метода. | |||||||||
Array ()
| |||||||||
{- "result": [
- {
- "id": 352,
- "title": "Товар закончился на складе продавца",
- "type_id": "seller",
- "is_available_for_cancellation": true
}, - {
- "id": 401,
- "title": "Продавец отклонил арбитраж",
- "type_id": "seller",
- "is_available_for_cancellation": false
}, - {
- "id": 402,
- "title": "Другое (вина продавца)",
- "type_id": "seller",
- "is_available_for_cancellation": true
}, - {
- "id": 666,
- "title": "Возврат из службы доставки: нет доставки в указанный регион",
- "type_id": "seller",
- "is_available_for_cancellation": false
}
]
}Возвращает количество заявок в конкретном статусе.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects | |||||
Array ()
| |||||
{ }{- "items": [
- {
- "count": 0,
- "order_state": "ORDER_STATE_UNSPECIFIED"
}
]
}Используйте метод, чтобы получить товарный состав поставки или черновика заявки на поставку. Одним вызовом метода можно получить состав одной поставки или черновика заявки.
| bundle_ids required | Array of strings [ 1 .. 100 ] items Идентификаторы товарного состава поставки. Можно получить в методе /v2/supply-order/get. |
| is_asc | boolean
|
| last_id | string Идентификатор последнего значения SKU на странице. |
| limit | integer <int32> [ 1 .. 100 ] Количество товаров на странице. |
| query | string Поисковый запрос, например: по названию, артикулу или SKU. |
| sort_field | string Default: "UNSPECIFIED" Enum: "UNSPECIFIED" "SKU" "NAME" "QUANTITY" "TOTAL_VOLUME_IN_LITRES" Сортировка по параметрам:
|
Array of objects Список товаров в заявке на поставку. | |
| total_count | integer <int32> Количество товаров в заявке. |
| has_next | boolean Признак, что в ответе вернули не все товары:
|
| last_id | string Идентификатор последнего значения на странице. |
{- "bundle_ids": [
- "string"
], - "is_asc": true,
- "limit": 0,
- "query": "string",
- "sort_field": "UNSPECIFIED"
}{- "items": [
- {
- "icon_path": "string",
- "sku": 0,
- "name": "string",
- "quantity": 0,
- "barcode": "string",
- "product_id": 0,
- "quant": 0,
- "is_quant_editable": true,
- "volume_in_litres": 0,
- "total_volume_in_litres": 0,
- "contractor_item_code": "string",
- "sfbo_attribute": "ITEM_SFBO_ATTRIBUTE_UNSPECIFIED",
- "shipment_type": "BUNDLE_ITEM_SHIPMENT_TYPE_UNSPECIFIED"
}
], - "total_count": 0,
- "has_next": true,
- "last_id": "string"
}Учитываются заявки с поставкой на конкретный склад и через виртуальный распределительный центр (вРЦ).
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
object Настройка отображения списка заявок. |
| last_supply_order_id | integer <int64> Идентификатор заявки на поставку, который вы запрашивали в прошлый раз. |
| supply_order_id | Array of strings <int64> Идентификатор заявки на поставку. |
{- "filter": {
- "states": [
- "ORDER_STATE_DATA_FILLING"
]
}, - "paging": {
- "from_supply_order_id": 0,
- "limit": 0
}
}{- "last_supply_order_id": 0,
- "supply_order_id": [
- "string"
]
}Учитываются заявки с поставкой на конкретный склад и через виртуальный распределительный центр (вРЦ).
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| order_ids | Array of strings <int64> Идентификатор заявки на поставку в системе Ozon. |
Array of objects Информация о заявке на поставку. | |
Array of objects Информация о складе. |
{- "order_ids": [
- "string"
]
}{- "orders": [
- {
- "creation_date": "string",
- "creation_flow": "string",
- "data_filling_deadline_utc": "2019-08-24T14:15:22Z",
- "dropoff_warehouse_id": 0,
- "state": "ORDER_STATE_UNSPECIFIED",
- "supplies": [
- {
- "bundle_id": "string",
- "storage_warehouse_id": 0,
- "supply_id": 0
}
], - "supply_order_id": 0,
- "supply_order_number": "string",
- "timeslot": [
- {
- "can_not_set_reasons": [
- "string"
], - "can_set": true,
- "is_required": true,
- "value": {
- "timeslot": [
- {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}
], - "timezone_info": [
- {
- "iana_name": "string",
- "offset": "string"
}
]
}
}
], - "vehicle": [
- {
- "can_not_set_reasons": [
- "string"
], - "can_set": true,
- "is_required": true,
- "value": [
- {
- "driver_name": "string",
- "driver_phone": "string",
- "vehicle_model": "string",
- "vehicle_number": "string"
}
]
}
]
}
], - "warehouses": [
- {
- "address": "string",
- "name": "string",
- "warehouse_id": 0
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| supply_order_id | integer <int64> Идентификатор заявки на поставку. |
Array of objects Интервалы поставки. | |
Array of objects Часовой пояс. |
{- "supply_order_id": 0
}{- "timeslots": [
- {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}
], - "timezone": [
- {
- "iana_name": "string",
- "offset": "string"
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| supply_order_id | integer <int64> Идентификатор заявки на поставку. |
object Время интервала поставки. |
| errors | Array of strings Items Enum: "UPDATE_TIMESLOT_ERROR_UNSPECIFIED" "UPDATE_TIMESLOT_ERROR_INVALID_ORDER_STATE" "UPDATE_TIMESLOT_ERROR_INCOMPATIBLE_ORDER_FLOW" "UPDATE_TIMESLOT_ERROR_SET_TIMESLOT_DEADLINE_EXCEED" "UPDATE_TIMESLOT_ERROR_OUT_OF_ALLOWED_RANGE" "UPDATE_TIMESLOT_ERROR_ORDER_NOT_BELONG_CONTRACTOR" "UPDATE_TIMESLOT_ERROR_ORDER_NOT_BELONG_COMPANY" Возможные ошибки:
|
| operation_id | string Идентификатор операции. |
{- "supply_order_id": 0,
- "timeslot": {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}
}{- "errors": [
- "UPDATE_TIMESLOT_ERROR_UNSPECIFIED"
], - "operation_id": "string"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| operation_id | string Идентификатор операции. |
| errors | Array of strings Items Enum: "UPDATE_TIMESLOT_ERROR_UNSPECIFIED" "UPDATE_TIMESLOT_ERROR_INVALID_ORDER_STATE" "UPDATE_TIMESLOT_ERROR_INCOMPATIBLE_ORDER_FLOW" "UPDATE_TIMESLOT_ERROR_SET_TIMESLOT_DEADLINE_EXCEED" "UPDATE_TIMESLOT_ERROR_OUT_OF_ALLOWED_RANGE" "UPDATE_TIMESLOT_ERROR_ORDER_NOT_BELONG_CONTRACTOR" "UPDATE_TIMESLOT_ERROR_ORDER_NOT_BELONG_COMPANY" Возможные ошибки:
|
| status | string Default: "STATUS_UNSPECIFIED" Enum: "STATUS_UNSPECIFIED" "STATUS_ERROR" "STATUS_IN_PROGRESS" "STATUS_SUCCESS" Статус данных:
|
{- "operation_id": "string"
}{- "errors": [
- "UPDATE_TIMESLOT_ERROR_UNSPECIFIED"
], - "status": "STATUS_UNSPECIFIED"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| supply_order_id | integer <int64> Идентификатор заявки на поставку. |
object Информация о водителе и автомобиле. |
| error_reasons | Array of strings Items Enum: "SET_VEHICLE_ERROR_UNSPECIFIED" "SET_VEHICLE_ERROR_INVALID_ORDER_STATE" "SET_VEHICLE_ERROR_VEHICLE_NOT_REQUIRED" "SET_VEHICLE_ERROR_ORDER_NOT_BELONG_CONTRACTOR" "SET_VEHICLE_ERROR_ORDER_NOT_BELONG_COMPANY" Причина ошибки:
|
| operation_id | string Идентификатор операции. |
{- "supply_order_id": 0,
- "vehicle": {
- "driver_name": "string",
- "driver_phone": "string",
- "vehicle_model": "string",
- "vehicle_number": "string"
}
}{- "error_reasons": [
- "SET_VEHICLE_ERROR_UNSPECIFIED"
], - "operation_id": "string"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| operation_id | string Идентификатор операции. |
| errors | Array of strings Items Enum: "SET_VEHICLE_ERROR_UNSPECIFIED" "SET_VEHICLE_ERROR_INVALID_ORDER_STATE" "SET_VEHICLE_ERROR_VEHICLE_NOT_REQUIRED" "SET_VEHICLE_ERROR_ORDER_NOT_BELONG_CONTRACTOR" "SET_VEHICLE_ERROR_ORDER_NOT_BELONG_COMPANY" Причина ошибки:
|
| result | string Default: "Unknown" Enum: "Unknown" "Success" "InProgress" "Failed" Статус ввода данных о водителе и автомобиле:
|
{- "operation_id": "string"
}{- "errors": [
- "SET_VEHICLE_ERROR_UNSPECIFIED"
], - "result": "Unknown"
}Метод возвращает список активных складов Ozon с информацией об их средней загруженности на ближайшее время.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Результат работы метода. | |||||
Array ()
| |||||
{- "result": [
- {
- "schedule": {
- "capacity": [
- {
- "start": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z",
- "value": 0
}
], - "date": "2019-08-24T14:15:22Z"
}, - "warehouse": {
- "id": "string",
- "name": "string"
}
}
]
}Метод для проверки кодов на соответствие требованиям системы «Честный ЗНАК» по количеству и составу символов.
Если у вас нет номера грузовой таможенной декларации (ГТД), вы можете его не указывать.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. |
object Результат работы метода. | |||
| |||
{- "posting_number": "23281294-0063-2",
- "products": [
- {
- "exemplars": [
- {
- "gtd": "",
- "mandatory_mark": "010290000151642731tVMohkbfFgunB",
- "jw_uin": ""
}
], - "product_id": 476925391
}
]
}{- "result": {
- "products": [
- {
- "product_id": 476925391,
- "exemplars": [
- {
- "mandatory_mark": "010290000151642731tVMohkbfFgunB",
- "jw_uin": "",
- "gtd": "",
- "valid": true,
- "errors": [ ]
}
], - "valid": true,
- "error": ""
}
]
}
}Асинхронный метод:
Чтобы получить результаты проверок, используйте метод /v4/fbs/posting/product/exemplar/status. Для получения данных о созданных экземплярах, используйте метод /v5/fbs/posting/product/exemplar/create-or-get.
При необходимости укажите номер грузовой таможенной декларации в параметре gtd.
Если его нет, передайте значение is_gtd_absent = true.
Если у вас несколько одинаковых товаров в отправлении, укажите один product_id и массив exemplars для каждого товара из отправления.
Всегда передавайте полный набор данных по экземплярам и продуктам.
Например, в вашей системе 10 экземпляров. Вы передали их для проверки и сохранения. Потом добавили в своей системе ещё 60 экземпляров. При повторной передаче экземпляров для проверки и сохранения укажите все экземпляры: и старые, и только что добавленные.
Отличие от /v4/fbs/posting/product/exemplar/set — вы можете передать в запросе больше информации по экземплярам.
Код ответа 200 не гарантирует, что данные об экземплярах приняты. Он указывает, что создана задача для добавления информации. Чтобы проверить статус задачи, используйте метод /v4/fbs/posting/product/exemplar/status.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| multi_box_qty | integer <int32> Количество коробок, в которые упакован товар. |
| posting_number required | string Номер отправления. |
required | Array of objects Список товаров. |
| result | boolean Результат обработки запроса. |
{- "multi_box_qty": 0,
- "posting_number": "string",
- "products": [
- {
- "exemplars": [
- {
- "exemplar_id": 0,
- "gtd": "string",
- "is_gtd_absent": true,
- "is_rnpt_absent": true,
- "mandatory_mark": "string",
- "rnpt": "string",
- "jw_uin": "string"
}
], - "is_gtd_needed": true,
- "is_mandatory_mark_needed": true,
- "is_rnpt_needed": true,
- "product_id": 0,
- "quantity": 0
}
]
}{- "result": true
}Асинхронный метод:
Чтобы получить результаты проверок, используйте метод /v4/fbs/posting/product/exemplar/status.
При необходимости укажите номер грузовой таможенной декларации в параметре gtd. Если его нет, передайте значение is_gtd_absent = true.
Если у вас несколько одинаковых товаров в отправлении, укажите один product_id и массив exemplars для каждого товара из отправления.
Всегда передавайте полный набор данных по экземплярам и продуктам.
Например, в вашей системе 10 экземпляров. Вы передали их для проверки и сохранения. Потом добавили в своей системе ещё 60 экземпляров. При повторной передаче экземпляров для проверки и сохранения укажите все экземпляры: и старые, и только что добавленные.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. |
| result | boolean Результат обработки запроса. |
{- "posting_number": "23281294-0063-2",
- "products": [
- {
- "exemplars": [
- {
- "gtd": "",
- "is_gtd_absent": true,
- "jw_uin": "",
- "mandatory_mark": "010290000151642731tVMohkbfFgunB"
}
], - "product_id": 476925391
}
]
}{- "result": true
}Метод для получения статусов добавления экземпляров, переданных в методе /v5/fbs/posting/product/exemplar/set. Также возвращает данные по этим экземплярам.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Номер отправления. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. | |
| status | string Статус проверки всех экземпляров и доступности сборки:
|
{- "posting_number": "23281294-0063-2"
}{- "posting_number": "23281294-0063-2",
- "products": [
- {
- "exemplars": [
- {
- "exemplar_id": "",
- "gtd": "",
- "gtd_check_status": "passed",
- "gtd_error_codes": [ ],
- "is_gtd_absent": true,
- "is_rnpt_absent": true,
- "jw_uin": "",
- "jw_uin_check_status": "passed",
- "jw_uin_error_codes": [ ],
- "mandatory_mark": "010290000151642731tVMohkbfFgunB",
- "mandatory_mark_check_status": "passed",
- "mandatory_mark_error_codes": [ ],
- "rnpt": "",
- "rnpt_check_status": "passed",
- "rnpt_error_codes": [ ]
}
], - "product_id": 476925391
}
], - "status": "ship_available"
}Метод для получения информации по экземплярам товаров из отправления, переданных в методе /v5/fbs/posting/product/exemplar/set.
Используйте метод для получения exemplar_id.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Номер отправления. |
| multi_box_qty | integer <int32> Количество коробок, в которые упакован товар. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. |
{- "posting_number": "string"
}{- "multi_box_qty": 0,
- "posting_number": "string",
- "products": [
- {
- "exemplars": [
- {
- "exemplar_id": 0,
- "gtd": "string",
- "is_gtd_absent": true,
- "is_rnpt_absent": true,
- "mandatory_mark": "string",
- "rnpt": "string",
- "jw_uin": "string"
}
], - "is_gtd_needed": true,
- "is_mandatory_mark_needed": true,
- "is_rnpt_needed": true,
- "product_id": 0,
- "quantity": 0
}
]
}Делит заказ на отправления и переводит его в статус awaiting_deliver.
Каждый элемент в packages может содержать несколько элементов products или отправлений.
Каждый элемент в products — это товар, включённый в данное отправление.
Разделить заказ нужно, если:
Чтобы разделить заказ, передайте в массиве packages несколько объектов.
Пример запроса, когда заказ разделять не нужно: 2 товара будут в одном отправлении.
{
"packages": [
{
"products": [
{
"product_id": 185479045,
"quantity": 2
}
]
}
],
"posting_number": "89491381-0072-1"
}Пример запроса, когда заказ нужно разделить: каждый товар будет в отдельном отправлении.
{
"packages": [
{
"products": [
{
"product_id": 185479045,
"quantity": 1
}
]
},
{
"products": [
{
"product_id": 185479045,
"quantity": 1
}
]
}
],
"posting_number": "89491381-0072-1"
} Чтобы внести информацию по экземплярам, используйте метод /v5/fbs/posting/product/exemplar/set.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Список упаковок. Каждая упаковка содержит список отправлений, на которые делится заказ. | |
| posting_number | string Номер отправления. |
object Дополнительная информация. |
Array of objects Дополнительная информация об отправлениях. | |
| result | Array of strings Результат сборки отправлений. |
{- "packages": [
- {
- "products": [
- {
- "product_id": 185479045,
- "quantity": 1
}
]
}
], - "posting_number": "89491381-0072-1",
- "with": {
- "additional_data": true
}
}{- "additional_data": [
- {
- "posting_number": "89491381-0072-1",
- "products": [
- {
- "currency_code": "RUB",
- "mandatory_mark": [
- "123"
], - "name": "string",
- "offer_id": "17125",
- "price": "2000",
- "quantity": 1,
- "sku": 149618972
}
]
}
], - "result": [
- "89491381-0072-1"
]
}Если в запросе передать часть товаров из отправления, метод разделит первичное отправление на две части. В первичном несобранном отправлении останется часть товаров, которую не передали в запросе.
По умолчанию статус созданных отправлений awaiting_packaging — ожидает сборки.
Статус изначального отправления изменится только после изменения статуса отправлений, на которые он разделился.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Номер отправления. |
Array of objects Список товаров в отправлении. |
| result | string Номера отправлений, сформированные после сборки. |
{- "posting_number": "string",
- "products": [
- {
- "exemplarsIds": [
- "string"
], - "product_id": 0,
- "quantity": 0
}
]
}{- "result": "string"
}Подтверждает отгрузку и запускает формирование транспортной накладной и штрихкода для отгрузки. Для продавцов из России также запускается формирование листа отгрузки, а для продавцов из СНГ — акта приёма-передачи.
Чтобы сформировать и получить документы, переведите отправление в статус awaiting_deliver.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| containers_count | integer <int32> Количество грузовых мест. Используйте параметр, если вы подключены к доверительной приёмке и отгружаете заказы грузовыми местами. Если вы не подключены к доверительной приёмке, пропустите его. |
| delivery_method_id | integer <int64> Идентификатор метода доставки. |
| departure_date | string <date-time> Дата отгрузки. |
object Результат работы метода. | |||
| |||
{- "containers_count": 1,
- "delivery_method_id": 230039077005,
- "departure_date": "2022-06-10T11:42:06.444Z"
}{- "result": {
- "id": 5819327210249
}
}Метод для получения перевозок, по которым нужно распечатать штрихкод для отгрузки и документы:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_method_id | integer <int64> Фильтр по методу доставки. |
| departure_date | string <date-time> Дата отгрузки. По умолчанию — текущая дата. |
Array of objects Результат работы метода. | |||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||
{- "delivery_method_id": 0,
- "departure_date": "2019-08-24T14:15:22Z"
}{- "result": [
- {
- "carriage_id": 0,
- "carriage_postings_count": 0,
- "carriage_status": "string",
- "cutoff_at": "2019-08-24T14:15:22Z",
- "delivery_method_id": 0,
- "delivery_method_name": "string",
- "errors": [
- {
- "code": "string",
- "status": "string"
}
], - "first_mile_type": "string",
- "has_entrusted_acceptance": true,
- "mandatory_postings_count": 0,
- "mandatory_packaged_count": 0,
- "recommended_time_local": "string",
- "recommended_time_utc_offset_in_minutes": 0,
- "tpl_provider_icon_url": "string",
- "tpl_provider_name": "string",
- "warehouse_city": "string",
- "warehouse_id": 0,
- "warehouse_name": "string",
- "warehouse_timezone": "string"
}
]
}| carriage_id | integer <int64> Идентификатор перевозки. |
| act_type | string Тип акта приёма-передачи. Актуально для продавцов FBS. |
| is_waybill_enabled | boolean
|
| is_econom | boolean
|
| arrival_pass_ids | Array of strings <int64> Список идентификаторов пропусков, оформленных на перевозку. |
| available_actions | Array of strings Доступные действия с перевозкой. |
object Возможность отмены. | |
| carriage_id | integer <int64> Идентификатор перевозки. |
| company_id | integer <int64> Идентификатор продавца. |
| containers_count | integer <int32> Количество грузовых мест. |
| created_at | string <date-time> Дата создания перевозки. |
| delivery_method_id | integer <int64> Идентификатор метода доставки. |
| departure_date | string Дата выполнения перевозки. |
| first_mile_type | string Тип первой мили. |
| has_postings_for_next_carriage | boolean
|
| integration_type | string Тип перевозки. |
| is_container_label_printed | boolean
|
| is_partial | boolean
|
| partial_num | integer <int64> Порядковый номер частичной перевозки. |
| retry_count | integer <int32> Количество повторных попыток создания перевозки. |
| status | string Статус перевозки:
|
| tpl_provider_id | integer <int64> Идентификатор провайдера доставки. |
| updated_at | string <date-time> Дата последнего обновления информации о перевозке. |
| warehouse_id | integer <int64> Идентификатор склада. |
{- "carriage_id": 0
}{- "act_type": "string",
- "is_waybill_enabled": true,
- "is_econom": true,
- "arrival_pass_ids": [
- "string"
], - "available_actions": [
- "string"
], - "cancel_availability": {
- "is_cancel_available": true,
- "reason": "string"
}, - "carriage_id": 0,
- "company_id": 0,
- "containers_count": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "delivery_method_id": 0,
- "departure_date": "string",
- "first_mile_type": "string",
- "has_postings_for_next_carriage": true,
- "integration_type": "string",
- "is_container_label_printed": true,
- "is_partial": true,
- "partial_num": 0,
- "retry_count": 0,
- "status": "string",
- "tpl_provider_id": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "warehouse_id": 0
}| posting_number required | string Номер отправления. |
required | Array of objects Список отправлений, на которые поделится заказ. За один запрос можно разделить один заказ. |
object Информация об изначальном отправлении. | |
Array of objects Список отправлений, на которые разделился заказ. |
{- "posting_number": "string",
- "postings": [
- {
- "products": [
- {
- "product_id": 0,
- "quantity": 0
}
]
}
]
}{- "parent_posting": {
- "posting_number": "string",
- "products": [
- {
- "product_id": 0,
- "quantity": 0
}
]
}, - "postings": [
- {
- "posting_number": "string",
- "products": [
- {
- "product_id": 0,
- "quantity": 0
}
]
}
]
}Возвращает список отправлений в акте по его идентификатору.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id | int <int64> Идентификатор акта. |
Array of objects Информация об отправлениях. | |||||||||||||||||
Array ()
| |||||||||||||||||
{- "id": 900000250859000
}{- "result": [
- {
- "id": 0,
- "multi_box_qty": 0,
- "posting_number": "string",
- "status": "string",
- "seller_error": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "created_at": "2019-08-24T14:15:22Z",
- "products": [
- {
- "name": "string",
- "offer_id": "string",
- "price": "string",
- "quantity": 0,
- "sku": 0
}
]
}
]
}Метод создает этикетки для грузового места.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id | integer <int64> Номер задания на формирование документов (также идентификатор перевозки) из метода POST /v2/posting/fbs/act/create. |
| file_content | string <byte> Содержание файла в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{- "id": 295662811
}{ "content_type": "application/pdf", "file_name": "carriage-containers-20903594.pdf", "file_content": "%PDF-1.4\n%âãÏÓ\n2 0 obj\n<</Length 2992/Filter/FlateDecode>>stream\nxµ}[ێ\u001c·\u0011}¯èç\u0000¦Èb\u0015/ @»+\u0019y0Ë\u0002ù\u0000%q\u0010X\u0001ìü?Ãn²ÉéfÍì(ò®\u001duMÝ/<Å\u0019\u001bòyýY,0Ã?=[ccyýåëå×K¡§\u000bAÂâ؉x\u001dßþqùÛ\u001fÿà-dp¢UÔø\u001aün)¿ùqÙ^üöóåݏùù¿«X¶i\t²JúçåÏøýõÙ$Gxn²\u0011&\u000f¥ÉCj¾§2aæºr&^,~hI²)F¤ù7¥íu£:oÊ\u0013Ùȹ0ûLdB\u001a\u0018y§xk;ë<^Lv)%¼)í\u0014öcyóÎX:\u0018ÚõIXå\u0015\u0013╏\r õɌ5dýÆ\u0016Ê!6Ñpys\u001aÄXYÃ1Ô\r:H©(%U´³bR" }
Метод для получения штрихкода, который нужно показать в пункте выдачи или сортировочном центре при отгрузке отправления.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id | integer <int64> Идентификатор перевозки. |
| file_content | string Изображение со штрихкодом в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{- "id": "295662811"
}{ "content_type": "image/png", "file_name": "20913984_barcode.png", "file_content": "PNG\r\n\u001a\n\u0000\u0000\u0000\rIHDR\u0000\u0000\u0003\u0010\u0000\u0000\u0000\u0010\u0000\u0000\u0000\u0000íZ\u000e'\u0000\u0000\u0002pIDATxìÕÁJ\u00031\u0014@Q+þÿ/×E\u0017\u000e¼\u0010u¡-ç¬$£Éˌp?î÷·§t» }ýü¸Ãcåz¹2wOWû\\Ϛ뫧×Ùö;ì|rÇýßîç¼úî{§¬N?í7oìv¸®µ¹Ãùû¹¾ÿÏ9ÿî?a¸ºéê7O&߿É9çÉ\u000eÏáý¯\u0007\u0000à\u0012\b\u0000@\u0000\u0004\u0002$\u0010\u0000$\u0000 \t\u0004\u0000I \u0000H\u0002\u0001@\u0012\b\u0000@\u0000\u0004\u0002$\u0010\u0000$\u0000 \t\u0004\u0000I \u0000H\u0002\u0001@\u0012\b\u0000@\u0000\u0004\u0002$\u0010\u0000$\u0000 \t\u0004\u0000I \u0000H\u0002\u0001@\u0012\b\u0000@\u0000\u0004\u0002$\u0010\u0000$\u0000 \t\u0004\u0000I \u0000H\u0002\u0001@\u0012\b\u0000@\u0000\u0004\u0002$\u0010\u0000" }
Используйте этот метод, чтобы получить штрихкод из ответа /v2/posting/fbs/act/get-barcode в текстовом виде.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id | integer <int64> Идентификатор перевозки. |
| result | string Штрихкод в текстовом виде. |
{- "id": "295662811"
}{- "result": "%303%24276481394"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id | integer <int64> Номер задания на формирование документов (также идентификатор перевозки) из метода POST /v2/posting/fbs/act/create. |
| id | integer <int64> Номер задания на формирование документов. |
| status | string Cтатус формирования документов:
|
{- "id": 0
}{- "id": 0,
- "status": "string"
}С помощью метода можно получить:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id | integer <int64> Номер задания на формирование документов (также идентификатор перевозки) из метода POST /v2/posting/fbs/act/create. |
| file_content | string <byte> Содержание файла в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{- "id": 22435521842000
}{ "content_type": "application/pdf", "file_name": "20928233.pdf", "file_content": "%PDF-1.4\n%âãÏÓ\n2 0 obj\n<</Length 13528/Filter/FlateDecode>>stream\nxí }[ ¯ä:vÞ{ ÿz\u000e{ { { }\\\\x1d\\\\xde/\\\\xc0{ } } } ]µw\u000fò` 9ój8ö\u0000í$¶\u0003ä燔Dº|\"µo ]ÝØ})D\\\\÷õNHßÿº°ðûoºì¿NñÎsïÝå\u001fþõÇÿù\u0011¯\u000be}ǍÑ\u0017©í¤4âòïÿøãïþËåßÂ7dÇ\u0014÷BðþYËÿ GðKüýßÿt\u0019þñïýñ۟äå¯ÿÑ?Ùq}\u0011Éø¸ê?añ«Ã?ú¯ªøÕN_\r8®.9\u0013¿þ\u001fáÜ]ò?íÛ\u000fç\u0011½Há/V°ø\"qÄø«O\\G\u000bµþDëõ'έ>ñ|}ëïpÆÅæ#³\u0018?ܣDxM>èT?¹ìÏ8ï͇aÞ×ßüöß.øÃo{û¯¯" }
Возвращает список актов по отгрузкам с возможностью отфильтровать отгрузки по периоду, статусу и типу интеграции.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Параметры фильтра. | |
| limit required | integer <int64> Максимальное количество актов в ответе. |
Array of objects Результат запроса. | |||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||
{- "filter": {
- "date_from": "2021-08-04",
- "date_to": "2022-08-04",
- "integration_type": "ozon",
- "status": [
- "delivered"
]
}, - "limit": 100
}{- "result": [
- {
- "id": null,
- "delivery_method_id": null,
- "delivery_method_name": "string",
- "integration_type": "string",
- "containers_count": null,
- "status": "string",
- "departure_date": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "act_type": "string",
- "is_partial": true,
- "has_postings_for_next_carriage": true,
- "partial_num": 0,
- "related_docs": {
- "act_of_acceptance": {
- "created_at": "2019-08-24T14:15:22Z",
- "document_status": "string"
}, - "act_of_mismatch": {
- "created_at": "2019-08-24T14:15:22Z",
- "document_status": "string"
}, - "act_of_excess": {
- "created_at": "2019-08-24T14:15:22Z",
- "document_status": "string"
}
}
}
]
}Вы можете получить документы, если в ответе метода /v2/posting/fbs/digital/act/check-status был один из статусов:
FORMED — перевозка сформирована успешно,CONFIRMED — перевозка подтверждена Ozon,CONFIRMED_WITH_MISMATCH — перевозка принята Ozon с расхождениями.| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id | integer <int64> Номер задания на формирование документов (также идентификатор перевозки) из метода POST /v2/posting/fbs/act/create. |
| doc_type | any <string> Тип электронного документа:
|
| file_content | string <byte> Содержание файла в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{- "id": 900000250859000,
- "doc_type": "act_of_acceptance"
}{ "content_type": "application/pdf", "file_name": "20816409_act_of_mismatch.pdf", "file_content": "%PDF-1.4\n%ÓôÌá\n1 0 obj\n<<\n/Creator(Chromium)\n/Producer(PDFsharp 1.50.5147 \\([www.pdfsharp.com|http://www.pdfsharp.com/]\\) \\(Original: Skia/PDF m103\\))\n/CreationDate(D:20230625092529+00'00')\n/ModDate(D:20230625092529+00'00')\n>>\nendobj\n2 0 obj\n<<\n/Type/Page\n/Resources\n<<\n/ProcSet[/PDF/Text/ImageB/ImageC/ImageI]\n/ExtGState\n<<\n/G3 3 0 R\n/G8 8 0 R\n>>\n/XObject\n<<\n/X6 6 0 R\n/X7 7 0 R\n>>\n/Font\n<<\n/F4 4 0 R\n/F5 5 0 R\n>>\n>>\n/MediaBox[0 0 594.96 841.92]\n/Contents 9 0 R\n/StructParents 0\n/Parent 13 0 R\n/Group\n<<\n/CS/DeviceRGB\n/S/Transparency\n>>\n>>\nendobj\n3 0 obj\n<<\n/ca 1\n/BM/Normal\n>>\nendobj\n4 0 obj\n<<\n/Type/Font\n/Subtype/Type0\n/BaseFont/AAAAAA+LiberationSans\n/Encoding/Identity-H\n/DescendantFonts[160 0 R]\n/ToUnicode 161 0 R\n>>\nendobj\n5 0 obj\n<<\n/Type/Font\n/Subtype/Type0\n/BaseFont/BAAAAA+LiberationSans-Bold\n/Encoding/Identity-H\n/DescendantFonts[164 0" }
Возвращает статус формирования штрихкода для отгрузки и документов:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id | integer <int64> Номер задания на формирование документов (также идентификатор перевозки) из метода POST /v2/posting/fbs/act/create. |
object Результат работы метода. | |||||||||||||||
| |||||||||||||||
{- "id": 900000250859000
}{- "result": {
- "added_to_act": [
- "true"
], - "removed_from_act": [
- "false"
], - "status": "ready"
}
}Добавить трек-номера к отправлениям. Вы можете передать до 20 трек-номеров за раз.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Массив с парами идентификатор отправления — трек-номер. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "tracking_numbers": [
- {
- "posting_number": "48173252-0033-2",
- "tracking_number": "123123123"
}
]
}{- "result": [
- {
- "error": "",
- "posting_number": "48173252-0033-2",
- "result": true
}
]
}Перевести отправление в статус «Отправлено продавцом». Статус доступен только продавцам с первой милей, продающим из-за рубежа.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | Array of strings Список идентификаторов отправлений. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "posting_number": [
- "47173252-0073-1"
]
}{- "result": [
- {
- "error": null,
- "posting_number": "47173252-0073-1",
- "result": true
}
]
}Перевести отправление в статус «Доставляется», если используется сторонняя служба доставки.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | Array of strings Идентификатор отправления. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "posting_number": [
- "33920157-0018-1"
]
}{- "result": [
- {
- "error": [ ],
- "posting_number": "33920157-0018-1",
- "result": true
}
]
}Перевести отправление в статус «Последняя миля», если используется сторонняя служба доставки.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | Array of strings Идентификатор отправления. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "posting_number": [
- "48173252-0033-2"
]
}{- "result": [
- {
- "error": [ ],
- "posting_number": "48173252-0033-2",
- "result": true
}
]
}Перевести отправление в статус «Доставлено», если используется сторонняя служба доставки.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | Array of strings Идентификатор отправления. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "posting_number": [
- "48173252-0033-2"
]
}{- "result": [
- {
- "error": [ ],
- "posting_number": "48173252-0033-2",
- "result": true
}
]
}Метод для получения доступных дат для переноса доставки и количества доступных переносов.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Номер отправления. |
object Период дат, доступных для переноса. | |
| remaining_changes_count | integer <int64> Количество оставшихся переносов. |
{- "posting_number": "string"
}{- "delivery_interval": {
- "begin": "2023-03-27T08:43:05.658Z",
- "end": "2023-03-27T08:43:05.658Z"
}, - "remaining_changes_count": 0
}Вы можете изменить дату доставки отправления не больше двух раз.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Новый период для даты доставки. | |
| posting_number | string Номер отправления. |
| result | boolean
|
{- "new_timeslot": {
- "from": "2023-03-25T08:51:56.932Z",
- "to": "2023-03-25T08:51:56.932Z"
}, - "posting_number": "string"
}{- "result": true
}Метод для отправлений, которые доставляет продавец или неинтегрированный перевозчик.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| new_cutoff_date required | string <date-time> Новая дата отгрузки. |
| posting_number required | string Номер отправления. |
| result | boolean
|
{- "new_cutoff_date": "2019-08-24T14:15:22Z",
- "posting_number": "string"
}{- "result": true
}| cursor | string Указатель для выборки следующих данных. |
object Фильтры. | |
| limit | integer <int32> Ограничение по количеству записей в ответе. По умолчанию — 1000. Максимум — 1000. |
Array of objects Список пропусков для перевозки. | |
| cursor | string Указатель для выборки следующих данных. Если параметр пустой, данных больше нет. |
{- "cursor": "string",
- "filter": {
- "arrival_pass_ids": [
- "string"
], - "arrival_reason": "string",
- "dropoff_point_ids": [
- "string"
], - "only_active_passes": true,
- "warehouse_ids": [
- "string"
]
}, - "limit": 0
}{- "arrival_passes": [
- {
- "arrival_pass_id": 0,
- "arrival_reasons": [
- "string"
], - "arrival_time": "2019-08-24T14:15:22Z",
- "driver_name": "string",
- "driver_phone": "string",
- "dropoff_point_id": 0,
- "is_active": true,
- "vehicle_license_plate": "string",
- "vehicle_model": "string",
- "warehouse_id": 0
}
], - "cursor": "string"
}Идентификатор созданного пропуска добавится к перевозке.
Array of objects Список пропусков. | |
| carriage_id | integer <int64> Идентификатор перевозки. |
| arrival_pass_ids | Array of strings <int64> Идентификаторы пропусков. |
{- "arrival_passes": [
- {
- "driver_name": "string",
- "driver_phone": "string",
- "vehicle_license_plate": "string",
- "vehicle_model": "string",
- "with_returns": true
}
], - "carriage_id": 0
}{- "arrival_pass_ids": [
- "string"
]
}Array of objects Список пропусков. | |
| carriage_id | integer <int64> Идентификатор перевозки. |
Пропуск обновлён
{- "arrival_passes": [
- {
- "driver_name": "string",
- "driver_phone": "string",
- "id": 0,
- "vehicle_license_plate": "string",
- "vehicle_model": "string",
- "with_returns": true
}
], - "carriage_id": 0
}{ }| arrival_pass_ids | Array of strings <int64> Идентификаторы пропусков. |
| carriage_id | integer <int64> Идентификатор перевозки. |
Пропуск удалён
{- "arrival_pass_ids": [
- "string"
], - "carriage_id": 0
}{ }Array of objects Список пропусков. |
| arrival_pass_ids | Array of strings <int64> Идентификаторы пропусков. |
{- "arrival_passes": [
- {
- "arrival_time": "2019-08-24T14:15:22Z",
- "driver_name": "string",
- "driver_phone": "string",
- "dropoff_point_id": 0,
- "vehicle_license_plate": "string",
- "vehicle_model": "string",
- "warehouse_id": 0
}
]
}{- "arrival_pass_ids": [
- "string"
]
}Array of objects Список пропусков. |
{- "arrival_passes": [
- {
- "arrival_pass_id": 0,
- "arrival_time": "2019-08-24T14:15:22Z",
- "driver_name": "string",
- "driver_phone": "string",
- "vehicle_license_plate": "string",
- "vehicle_model": "string"
}
]
}{ }| arrival_pass_ids | Array of strings <int64> Идентификаторы пропусков. |
{- "arrival_pass_ids": [
- "string"
]
}{ }Метод для получения информации о возвращённых товарах, которые продаются со склада Ozon.
object Фильтр. | |
| last_id | integer <int64> Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
| limit | integer <int64> Количество значений в ответе. |
| last_id | integer <int64> Идентификатор последнего значения на странице. |
Array of objects Информация о возвратах. |
{- "filter": {
- "posting_number": "string",
- "status": [
- "string"
]
}, - "last_id": 0,
- "limit": 0
}{- "last_id": 0,
- "returns": [
- {
- "accepted_from_customer_moment": "2019-08-24T14:15:22Z",
- "company_id": 0,
- "current_place_name": "string",
- "dst_place_name": "string",
- "id": 0,
- "is_opened": true,
- "posting_number": "string",
- "return_id": 0,
- "return_reason_name": "string",
- "returned_to_ozon_moment": "2019-08-24T14:15:22Z",
- "sku": 0,
- "status_name": "string"
}
]
}Метод для получения информации о возвращённых товарах, которые продаются со склада продавца.
object Фильтр. | |
| limit | integer <int64> Количество значений в ответе:
|
| last_id | integer <int64> Идентификатор возврата, который был загружен в предыдущий раз. В ответе будут возвраты, идентификаторы которых больше значения в |
| last_id | integer <int64> Идентификатор возврата, который был загружен в предыдущий раз. В ответе будут возвраты, идентификаторы которых больше значения в |
Array of objects Информация о возвратах. |
{- "filter": {
- "last_free_waiting_day": {
- "time_from": "2019-08-24T14:15:22Z",
- "time_to": "2019-08-24T14:15:22Z"
}, - "order_id": 0,
- "posting_number": [
- "string"
], - "product_name": "string",
- "product_offer_id": "string",
- "status": "string"
}, - "limit": 0,
- "last_id": 0
}{- "last_id": 0,
- "returns": [
- {
- "clearing_id": 0,
- "commission": 0,
- "commission_percent": 0,
- "exemplar_id": 0,
- "id": 0,
- "is_moving": true,
- "is_opened": true,
- "last_free_waiting_day": "string",
- "place_id": 0,
- "moving_to_place_name": "string",
- "picking_amount": 0,
- "posting_number": "string",
- "picking_tag": "string",
- "price": 0,
- "price_without_commission": 0,
- "product_id": 0,
- "product_name": "string",
- "quantity": 0,
- "return_barcode": "string",
- "return_clearing_id": 0,
- "return_date": "string",
- "return_reason_name": "string",
- "waiting_for_seller_date_time": "string",
- "returned_to_seller_date_time": "string",
- "waiting_for_seller_days": 0,
- "returns_keeping_cost": 0,
- "sku": 0,
- "status": "string"
}
]
}object Фильтры. Используйте только один фильтр в запросе: | |
| limit required | integer <int32> Количество подгружаемых возвратов. Максимальное значение — 500. |
| last_id | integer <int64> Идентификатор последнего подгруженного возврата. |
Array of objects Информация о возвратах. | |
| has_next | boolean
|
{- "filter": {
- "logistic_return_date": {
- "time_from": "2019-08-24T14:15:22Z",
- "time_to": "2019-08-24T14:15:22Z"
}, - "storage_tariffication_start_date": {
- "time_from": "2019-08-24T14:15:22Z",
- "time_to": "2019-08-24T14:15:22Z"
}, - "visual_status_change_moment": {
- "time_from": "2019-08-24T14:15:22Z",
- "time_to": "2019-08-24T14:15:22Z"
}, - "order_id": "0",
- "posting_numbers": [
- "string"
], - "product_name": "string",
- "offer_id": "string",
- "visual_status_name": "string",
- "warehouse_id": "911",
- "barcode": "string",
- "return_schema": "FBO"
}, - "limit": 500,
- "last_id": 0
}{- "returns": [
- {
- "exemplars": [
- {
- "id": "1019562967545956"
}
], - "id": "1000015552",
- "company_id": "3058",
- "return_reason_name": "Покупатель отказался при вручении: недоволен качеством товара",
- "type": "FullReturn",
- "schema": "Fbs",
- "order_id": "24540784250",
- "order_number": "58544282-0057",
- "place": {
- "id": "23869688194000",
- "name": "СЦ_Львовский_Возвраты",
- "address": "Россия, обл. Московская, г. Подольск, промышленная зона Львовский, ул. Московская, д. 69, стр. 5"
}, - "target_place": {
- "id": "23869688194000",
- "name": "СЦ_Львовский_Возвраты",
- "address": "Россия, обл. Московская, г. Подольск, промышленная зона Львовский, ул. Московская, д. 69, стр. 5"
}, - "storage": {
- "sum": {
- "currency_code": "RUB",
- "price": "1231"
}, - "tariffication_first_date": "2024-07-30T06:15:48.998146Z",
- "tariffication_start_date": "2024-07-29T06:15:48.998146Z",
- "arrived_moment": "2024-07-29T06:15:48.998146Z",
- "days": "0",
- "utilization_sum": {
- "currency_code": "RUB",
- "price": "1231"
}, - "utilization_forecast_date": "2024-07-29T06:15:48.998146Z"
}, - "product": {
- "sku": "1100526203",
- "offer_id": "81451",
- "name": "Кукла Дотти Плачущий младенец Cry Babies Dressy Dotty",
- "price": {
- "currency_code": "RUB",
- "price": "3318"
}, - "price_without_commission": {
- "currency_code": "RUB",
- "price": "3318"
}, - "commission_percent": "1.2",
- "commission": {
- "currency_code": "RUB",
- "price": "2312"
}, - "quantity": 1
}, - "logistic": {
- "technical_return_moment": "2024-07-29T06:15:48.998146Z",
- "final_moment": "2024-07-29T06:15:48.998146Z",
- "cancelled_with_compensation_moment": "2024-07-29T06:15:48.998146Z",
- "return_date": "2024-07-29T06:15:48.998146Z",
- "barcode": "ii5275210303"
}, - "visual": {
- "status": {
- "id": 3,
- "display_name": "В пункте выдачи",
- "sys_name": "ArrivedAtReturnPlace"
}, - "change_moment": "2024-07-29T06:15:48.998146Z"
}, - "additional_info": {
- "is_opened": true,
- "is_super_econom": false
}, - "source_id": "90426223",
- "posting_number": "58544282-0057-1",
- "clearing_id": "21190893156000",
- "return_clearing_id": null
}
], - "has_next": false
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
| last_id | integer <int32> Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. |
| limit required | integer <int32> Количество значений в ответе. |
object Данные о заявках. | |||||||||||||||||
| |||||||||||||||||
{- "filter": {
- "offer_id": "string",
- "posting_number": "string",
- "group_state": [
- "string"
], - "created_at": {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}
}, - "last_id": 0,
- "limit": 0
}{- "returns": {
- "client_name": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "order_number": "string",
- "posting_number": "string",
- "product": {
- "name": "string",
- "offer_id": "string",
- "currency_code": "string",
- "price": "string",
- "sku": 0
}, - "return_id": 0,
- "return_number": "string",
- "state": {
- "group_state": "string",
- "money_return_state_name": "string",
- "state": "string",
- "state_name": "string"
}
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| return_id required | integer <int64> Идентификатор заявки. |
object Данные о заявке. | |||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||
{- "return_id": 0
}{- "returns": {
- "available_actions": [
- {
- "id": 0,
- "name": "string"
}
], - "client_name": "string",
- "client_photo": [
- "string"
], - "client_return_method_type": {
- "id": 0,
- "name": "string"
}, - "comment": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "order_number": "string",
- "posting_number": "string",
- "product": {
- "name": "string",
- "offer_id": "string",
- "currency_code": "string",
- "price": "string",
- "sku": 0
}, - "rejection_comment": "string",
- "rejection_reason": [
- {
- "hint": "string",
- "id": 0,
- "is_comment_required": true,
- "name": "string"
}
], - "return_method_description": "string",
- "return_number": "string",
- "return_reason": {
- "id": 0,
- "is_defect": true,
- "name": "string"
}, - "ru_post_tracking_number": "string",
- "state": {
- "state": "string",
- "state_name": "string"
}, - "warehouse_id": 0
}
}Метод позволяет отклонить заявку на возврат rFBS-заказа. Вы можете объяснить своё решение в параметре comment.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| return_id required | integer <int64> Идентификатор заявки на возврат. |
| comment | string Комментарий. Передайте комментарий, если в ответе метода /v2/returns/rfbs/get параметр |
| rejection_reason_id required | integer <int64> Идентификатор причины отмены. Передайте идентификатор из списка причин, полученного в ответе метода /v2/returns/rfbs/get в параметре |
{- "return_id": 0,
- "comment": "string",
- "rejection_reason_id": 0
}{ }Метод для частичной компенсации стоимости товара: вы возвращаете часть денег покупателю, товар остаётся у него.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| compensation_amount | string Сумма компенсации. |
| return_id required | integer <int64> Идентификатор заявки на возврат. |
{- "compensation_amount": "string",
- "return_id": 0
}{ }Метод позволяет одобрить заявку и согласиться на получение товара для проверки.
Подтвердите получение товара с помощью метода /v2/returns/rfbs/receive-return.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| return_id required | integer <int64> Идентификатор заявки на возврат. |
| return_method_description | string Способ возврата товара. |
{- "return_id": 0,
- "return_method_description": "string"
}{ }| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| return_id required | integer <int64> Идентификатор заявки на возврат. |
{- "return_id": 0
}{ }Метод подтверждает возврат полной стоимости товара. Используйте метод, если согласны:
Если товар оказался ненадлежащего качества или с браком, вы возмещаете покупателю стоимость пересылки товара.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| return_id required | integer <int64> Идентификатор заявки на возврат. |
| return_for_back_way | integer <int64> Сумма, возмещаемая покупателю за пересылку товара. |
{- "return_id": 0,
- "return_for_back_way": 0
}{ }Метод для получения информации о возвратах FBS и их количестве.
object Фильтры. | |
object Разделение ответа метода. |
Array of objects Информация о drop-off пунктах. | |
| has_next | boolean Признак, есть ли ещё пункты, где продавца ожидают возвраты. |
{- "filter": {
- "place_id": 0
}, - "pagination": {
- "last_id": 0,
- "limit": 0
}
}{- "drop_off_points": [
- {
- "address": "string",
- "box_count": 0,
- "id": 0,
- "name": "string",
- "pass_info": {
- "count": 0,
- "is_required": true
}, - "place_id": 0,
- "returns_count": 0,
- "utc_offset": "string",
- "warehouses_ids": [
- "string"
]
}
], - "has_next": true
}Если у вас есть доступ, в параметре enabled будет указано значение true.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| enabled | boolean
|
{ }{- "enabled": true
}Метод для получения списка активных возвратов. Возвратная отгрузка становится активной после сканирования штрихкода. После сканирования штрихкода второй раз активная выдача переходит в статус неактивной.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| last_id | integer <int64> Идентификатор последнего значения на странице. |
| limit | integer <int64> Количество элементов в ответе. |
Array of objects Идентификатор отгрузки. | |||||||||||||||||
Array ()
| |||||||||||||||||
{- "last_id": 0,
- "limit": 0
}{- "giveouts": [
- {
- "approved_articles_count": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "giveout_id": 0,
- "giveout_status": "string",
- "total_articles_count": 0,
- "warehouse_address": "string",
- "warehouse_id": 0,
- "warehouse_name": "string"
}
]
}Метод для получения информации о возвратной отгрузке.
В параметр giveout_id передаётся значение, полученное в методе /v1/return/giveout/list.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| giveout_id | integer <int64> Идентификатор отгрузки. |
Array of objects Артикулы товаров. | |
| giveout_id | integer <int64> Идентификатор отгрузки. |
| giveout_status | string Статусы возвратной отгрузки:
|
| warehouse_address | string Адрес склада. |
| warehouse_name | string Название склада. |
{- "giveout_id": 0
}{- "articles": [
- {
- "approved": true,
- "delivery_schema": "string",
- "name": "string",
- "seller_id": 0
}
], - "giveout_id": 0,
- "giveout_status": "string",
- "warehouse_address": "string",
- "warehouse_name": "string"
}Используйте этот метод, чтобы получить штрихкод из ответа методов /v1/return/giveout/get-png и /v1/return/giveout/get-pdf в текстовом виде.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| barcode | string Значение штрихкода в текстовом виде. |
{ }{- "barcode": "string"
}Возвращает PDF-файл со штрихкодом. Метод работает только для схемы FBS.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| file_content | string PDF-файл со штрихкодом в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{ }{ "content_type": "application/pdf", "file_name": "string", "file_content": "string" }
Возвращает PNG-файл со штрихкодом.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| file_content | string PNG-файл со штрихкодом в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{ }{ "content_type": "image/png", "file_name": "string", "file_content": "string" }
Используйте метод, если ваш штрихкод попал в посторонние руки.
Метод возвращает PNG-файл с новым штрихкодом. После использования метода вы не сможете получить возвратную отгрузку по старым штрихкодам. Чтобы получить новый штрихкод в PDF-формате, запросите его методом /v1/return/giveout/get-pdf.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| file_content | string Изображение со штрихкодом в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{ }{ "content_type": "image/png", "file_name": "string", "file_content": "string" }
Метод для получения информации о заявке на отмену rFBS-заказа.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cancellation_id required | integer <int64> Идентификатор заявки на отмену. |
object Результат запроса. | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
{- "cancellation_id": 90066344
}{- "result": {
- "cancellation_id": 90066344,
- "posting_number": "47134289-0029-1",
- "cancellation_reason": {
- "id": 508,
- "name": "Покупатель отменил заказ"
}, - "cancelled_at": "2022-04-07T06:37:26.871105Z",
- "cancellation_reason_message": "Изменение пункта выдачи заказа.",
- "tpl_integration_type": "ThirdPartyTracking",
- "state": {
- "id": 2,
- "name": "Подтверждена",
- "state": "APPROVED"
}, - "cancellation_initiator": "CLIENT",
- "order_date": "2022-04-06T17:17:24.517Z",
- "approve_comment": "",
- "approve_date": "2022-04-07T07:52:45.971824Z",
- "auto_approve_date": "2022-04-09T06:37:26.871105Z"
}
}Метод для получения списка заявок на отмену rFBS-заказов.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтры. | |
| limit required | integer <int32> Количество заявок в ответе. |
| offset | integer <int32> Количество элементов, которое будет пропущено в ответе. Например, если |
object Дополнительная информация. |
Array of objects Список заявок на отмену. | |||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||
| total | integer <int32> Общее количество заявок по заданным фильтрам. | ||||||||||||||||||||||||
object Cчётчик заявок в разных статусах. | |||||||||||||||||||||||||
{- "filters": {
- "cancellation_initiator": [
- "CLIENT"
], - "posting_number": [ ],
- "state": "ALL"
}, - "limit": 2,
- "offset": 0,
- "with": {
- "counters": true
}
}{- "result": [
- {
- "cancellation_id": 50186754,
- "posting_number": "41267064-0032-1",
- "cancellation_reason": {
- "id": 508,
- "name": "Покупатель отменил заказ"
}, - "cancelled_at": "2021-09-03T07:17:12.116114Z",
- "cancellation_reason_message": "",
- "tpl_integration_type": "ThirdPartyTracking",
- "state": {
- "id": 2,
- "name": "Подтверждена",
- "state": "APPROVED"
}, - "cancellation_initiator": "CLIENT",
- "order_date": "2021-09-03T07:04:53.220Z",
- "approve_comment": "",
- "approve_date": "2021-09-03T09:13:12.614200Z",
- "auto_approve_date": "2021-09-06T07:17:12.116114Z"
}, - {
- "cancellation_id": 51956491,
- "posting_number": "14094410-0018-1",
- "cancellation_reason": {
- "id": 507,
- "name": "Покупатель передумал"
}, - "cancelled_at": "2021-09-13T15:03:25.155827Z",
- "cancellation_reason_message": "",
- "tpl_integration_type": "ThirdPartyTracking",
- "state": {
- "id": 5,
- "name": "Автоматически отменена",
- "state": "REJECTED"
}, - "cancellation_initiator": "CLIENT",
- "order_date": "2021-09-13T07:48:50.143Z",
- "approve_comment": "",
- "approve_date": null,
- "auto_approve_date": "2021-09-16T15:03:25.155827Z"
}
], - "total": 19,
- "counters": {
- "on_approval": 0,
- "approved": 14,
- "rejected": 5
}
}Метод позволяет согласовать заявку на отмену в статусе ON_APPROVAL. Метод применим для rFBS-заказов. Заказ будет отменён, а деньги вернутся покупателю.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cancellation_id required | integer <int64> Идентификатор заявки на отмену. |
| comment | string Комментарий. |
{- "cancellation_id": 74393917
}{ }Метод позволяет отклонить заявку на отмену в статусе ON_APPROVAL. Метод применим для rFBS-заказов. Объясните своё решение в параметре comment.
Заказ останется в том же статусе, и его нужно будет доставить покупателю.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cancellation_id required | integer <int64> Идентификатор заявки на отмену. |
| comment | string Комментарий. |
{- "cancellation_id": 52394916,
- "comment": "Заявка на отмену отклоняется. Заказ будет доставлен в указанные сроки. При необходимости вы можете оформить возврат."
}{ }Отправляет сообщение в существующий чат по его идентификатору.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| chat_id required | string Идентификатор чата. |
| text required | string Текст сообщения в формате plain text от 1 до 1000 символов. |
| result | string Результат обработки запроса. |
{- "chat_id": "99feb3fc-a474-469f-95d5-268b470cc607",
- "text": "test"
}{- "result": "success"
}Отправляет файл в существующий чат по его идентификатору.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| base64_content | string Файл в виде строки base64. |
| chat_id | string Идентификатор чата. |
| name | string Название файла с расширением. |
| result | string Результат обработки запроса. |
{- "base64_content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=",
- "chat_id": "99feb3fc-a474-469f-95d5-268b470cc607",
- "name": "tempor"
}{- "result": "success"
}Создает новый чат с покупателем по отправлению. Например, чтобы уточнить адрес или модель товара.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Идентификатор отправления. |
object Результат работы метода. | |||
| |||
{- "posting_number": "47873153-0052-1"
}{- "result": {
- "chat_id": "5969c331-2e64-44b7-8a0e-ff9526762c62"
}
}Возвращает информацию о чатах по указанным фильтрам.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по чатам. | |
| limit | integer <int64> Количество значений в ответе. Значение по умолчанию — 30. Максимальное значение — 1000. |
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
Array of objects Данные чатов. | |
| total_chats_count | integer <int64> Общее количество чатов. |
| total_unread_count | integer <int64> Общее количество непрочитанных сообщений. |
{- "filter": {
- "chat_status": "Opened",
- "unread_only": true
}, - "limit": 1,
- "offset": 0
}{- "chats": [
- {
- "chat": {
- "created_at": "2022-07-22T08:07:19.581Z",
- "chat_id": "5e767w03-b400-4y1b-a841-75319ca8a5c8",
- "chat_status": "Opened",
- "chat_type": "Seller_Support"
}, - "first_unread_message_id": "3000000000118021931",
- "last_message_id": "30000000001280042740",
- "unread_count": 1
}
], - "total_chats_count": 25,
- "total_unread_count": 5
}Возвращает историю сообщений чата. По умолчанию от самого нового сообщения к старым.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| chat_id required | string Идентификатор чата. |
| direction | string Направление сортировки сообщений:
Значение по умолчанию — |
| from_message_id | integer <uint64> Идентификатор сообщения, с которого начать вывод истории чата. По умолчанию — последнее видимое сообщение. |
| limit | integer <int64> Количество сообщений в ответе. По умолчанию — 50. Максимальное значение — 1000. |
| has_next | boolean Признак, что в ответе вернули не все сообщения. |
Array of objects Массив сообщений, отсортированный в соответсвии с параметром |
{- "chat_id": "18b8e1f9-4ae7-461c-84ea-8e1f54d1a45e",
- "direction": "Forward",
- "from_message_id": 3000000000118032000,
- "limit": 1
}{- "has_next": true,
- "messages": [
- {
- "message_id": "3000000000817031942",
- "user": {
- "id": "115568",
- "type": "Сustomer"
}, - "created_at": "2022-07-18T20:58:04.528Z",
- "is_read": true,
- "data": [
- "Здравствуйте, у меня вопрос по вашему товару \"Стекло защитное для смартфонов\", артикул 11223. Подойдет ли он на данную [ модель ](https://www.ozon.ru/product/smartfon-samsung-galaxy-a03s-4-64-gb-chernyy) телефона?"
]
}
]
}Метод для отметки выбранного сообщения и сообщений до него прочитанными.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| chat_id required | string Идентификатор чата. |
| from_message_id required | integer <uint64> Идентификатор сообщения. |
| unread_count | integer <int64> Количество непрочитанных сообщений в чате. |
{- "chat_id": "99feb3fc-a474-469f-95d5-268b470cc607",
- "from_message_id": 3000000000118032000
}{- "unread_count": 0
}Создание или изменение таможенного счёта-фактуры для возврата НДС продавцам из Турции.
| date | string <date-time> Дата счёта-фактуры. |
Array of objects HS-коды товаров. | |
| number | string Номер счёта-фактуры. Номер может содержать буквы и цифры, максимальная длина — 50 символов. |
| posting_number | string Номер отправления. |
| price | number <double> Стоимость, указанная в счёте-фактуре. Разделитель дробной части — точка, до двух знаков после точки. |
| price_currency | string Валюта счёта-фактуры:
Значение по умолчанию — |
| url | string Ссылка на счёт-фактуру. Чтобы создать ссылку, используйте метод v1/invoice/file/upload. |
| result | boolean Результат работы метода. |
{- "HS_code": [
- {
- "sku": "SKU123",
- "code": "534758761999"
}, - {
- "sku": "SKU456",
- "code": "534758761000"
}, - {
- "sku": "SKU789",
- "code": "534758761777"
}
], - "date": "2023-08-01T12:08:44.342Z",
- "number": "424fdsf234",
- "posting_number": "33920146-0252-1",
- "price": 234.34,
- "price_currency": "RUB",
}{- "result": true
}Доступные форматы: JPEG и PDF. Максимальный размер файла: 10 МБ.
| base64_content | string Счёт-фактура в кодировке Base64. |
| posting_number | string Номер отправления. |
| url | string Ссылка на счёт-фактуру. |
{- "base64_content": "string",
- "posting_number": "string"
}{- "url": "string"
}| posting_number | string Номер отправления. |
object Информация о счёте-фактуре. | |||||||||||||
| |||||||||||||
{- "posting_number": "string"
}{- "result": {
- "date": "2019-08-24T14:15:22Z",
- "file_url": "string",
- "hs_codes": [
- {
- "code": "string",
- "sku": "string"
}
], - "number": "string",
- "price": 0,
- "price_currency": "string"
}
}| posting_number | string Номер отправления. |
| result | boolean Результат работы метода. |
{- "posting_number": "string"
}{- "result": true
}Возвращает информацию о созданном ранее отчёте по его идентификатору.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| code | string Уникальный идентификатор отчёта. |
object Информация об отчёте. | |||||||||||||||
| |||||||||||||||
{- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69"
}{- "result": {
- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27",
- "status": "success",
- "error": "",
- "report_type": "seller_products",
- "params": { },
- "created_at": "2021-11-25T14:54:55.688260Z"
}
}Возвращает список отчётов, которые были сформированы раньше.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| page | integer <int32> Номер страницы. |
| page_size | integer <int32> Количество значений на странице:
|
| report_type | string Default: "ALL" Тип отчёта:
|
object Результаты запроса. | |||||
| |||||
{- "page": 0,
- "page_size": 1000,
- "report_type": "ALL"
}{- "result": {
- "reports": [
- {
- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69",
- "status": "success",
- "error": "",
- "report_type": "seller_products",
- "params": {
- "visibility": "3"
}, - "created_at": "2019-02-06T12:09:47.258062Z"
}, - {
- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69",
- "status": "success",
- "error": "",
- "report_type": "seller_products",
- "params": {
- "visibility": "3"
}, - "created_at": "2019-02-15T08:34:32.267178Z"
}
], - "total": 2
}
}Метод для получения отчёта с данными о товарах. Например, Ozon ID, количества товаров, цен, статуса. Соответствует разделу/действию Товары и цены → Список товаров → Скачать → Товары CSV в личном кабинете.
Пояснения к некоторым полям:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| language | string Default: "DEFAULT" Язык ответа:
|
| offer_id | Array of strings Идентификатор товара в системе продавца. |
| search | string Поиск по содержанию записи, проверяет наличие. |
| sku | Array of integers <int64> Идентификатор товара в системе Ozon. |
| visibility | string Default: "ALL" Фильтр по видимости товара:
|
object Результаты запроса. | |||
| |||
{- "language": "DEFAULT",
- "offer_id": [ ],
- "search": "",
- "sku": [ ],
- "visibility": "ALL"
}{- "result": {
- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69"
}
}Метод для получения отчёта о возвратах FBO и FBS.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
| language | string Default: "DEFAULT" Язык ответа:
|
| code | string Уникальный идентификатор отчёта. По нему вы можете получить отчёт в течение 3 дней после запроса. |
{- "filter": {
- "delivery_schema": "fbs",
- "date_from": "2024-09-16T00:00:00.000Z",
- "date_to": "2024-09-19T23:59:59.999Z",
- "status": "MovingToSeller"
}, - "language": "DEFAULT"
}{- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69"
}Отчёт содержит информацию о возвращённых товарах, которые приняты от покупателя, готовы к получению или переданы продавцу. Соответствует разделу Аналитика → Отчёты → Возвраты → FBS в личном кабинете.
Метод подходит только для заказов, которые отправлены со склада продавца.
Пояснения к некоторым полям в отчёте:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
| language | string Default: "DEFAULT" Язык ответа:
|
object Результаты запроса. | |||
| |||
{- "filter": {
- "delivery_schema": "fbs",
- "order_id": 0,
- "status": ""
}, - "language": "DEFAULT"
}{- "result": {
- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69"
}
}Отчёт об отправлениях с информацией по заказам:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
| language | string Default: "DEFAULT" Язык ответа:
|
object Результаты запроса. | |||
| |||
{- "filter": {
- "processed_at_from": "2021-09-02T17:10:54.861Z",
- "processed_at_to": "2021-11-02T17:10:54.861Z",
- "delivery_schema": [
- "fbo"
], - "sku": [ ],
- "cancel_reason_id": [ ],
- "offer_id": "",
- "status_alias": [ ],
- "statuses": [ ],
- "title": ""
}, - "language": "DEFAULT"
}{- "result": {
- "code": "REPORT_seller_postings_514893_1722847571_32a3508c-6b53-408c-a212-6c97138d23ed"
}
}Метод для получения финансового отчёта за периоды с 01 по 15 и с 16 по 31. Запросить отчёт за отдельные дни не получится. Соответствует разделу Финансы → Список отчётов в личном кабинете.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | object Период формирования отчёта. |
| page required | integer <int32> Номер страницы, возвращаемой в запросе. |
| with_details | boolean
|
| page_size required | integer <int32> Количество элементов на странице. |
object Результат работы метода. | |||||||
| |||||||
{- "date": {
- "from": "2022-01-01T00:00:00.000Z",
- "to": "2022-12-31T00:00:00.000Z"
}, - "with_details": true,
- "page": 1,
- "page_size": 1
}{- "result": {
- "cash_flows": [
- {
- "commission_amount": 1437,
- "currency_code": "string",
- "item_delivery_and_return_amount": 1991,
- "orders_amount": 1000,
- "period": {
- "begin": "2023-04-03T09:12:10.239Z",
- "end": "2023-04-03T09:12:10.239Z",
- "id": 11567022278500
}, - "returns_amount": -3000,
- "services_amount": 8471.28
}
], - "details": {
- "period": {
- "begin": "2023-04-03T09:12:10.239Z",
- "end": "2023-04-03T09:12:10.239Z",
- "id": 11567022278500
}, - "payments": [
- {
- "payment": 0,
- "currency_code": "string"
}
], - "begin_balance_amount": 0,
- "delivery": {
- "total": 0,
- "amount": 0,
- "delivery_services": {
- "total": 0,
- "items": [
- {
- "name": "string",
- "price": 0
}
]
}
}, - "return": {
- "total": 0,
- "amount": 0,
- "return_services": {
- "total": 0,
- "items": [
- {
- "name": "string",
- "price": 0
}
]
}
}, - "loan": 0,
- "invoice_transfer": 0,
- "rfbs": {
- "total": 0,
- "transfer_delivery": 0,
- "transfer_delivery_return": 0,
- "compensation_delivery_return": 0,
- "partial_compensation": 0,
- "partial_compensation_return": 0
}, - "services": {
- "total": 0,
- "items": [
- {
- "name": "string",
- "price": 0
}
]
}, - "others": {
- "total": 0,
- "items": [
- {
- "name": "string",
- "price": 0
}
]
}, - "end_balance_amount": 0
}
}, - "page_count": 15
}Запускает генерацию отчёта по уценённым товарам на складе Ozon. Ozon может сам уценить товар, например, при повреждении.
В результате запроса будет не сам отчёт, а его уникальный идентификатор. Чтобы получить отчёт, отправьте идентификатор в запросе метода /v1/report/info.
С одного аккаунта продавца можно отправить 1 запрос в минуту. Соответствует разделу Аналитика → Отчёты → Продажи со склада Ozon → Товары, уценённые Ozon в личном кабинете.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| code | string Уникальный идентификатор отчёта. |
{ }{- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69"
}Отчёт с информацией о количестве доступных и зарезервированных единиц товара на складе. Соответствует разделу FBS → Управление логистикой → Управление остатками → Скачать в XLS в личном кабинете.
В результате запроса будет не сам отчёт, а его уникальный идентификатор. Чтобы получить отчёт, отправьте идентификатор в запросе метода /v1/report/info.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| language | string Default: "DEFAULT" Язык ответа:
|
| warehouseId | Array of strings <int64> Идентификаторы складов. |
object Результаты запроса. | |||
| |||
{- "language": "DEFAULT",
- "warehouseId": [
- "string"
]
}{- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69"
}Уĸажите период и метриĸи, ĸоторые нужно посчитать. В ответе будет аналитиĸа, сгруппированная по параметру dimensions.
Для продавцов без Premium-подписки:
Для продавцов с Premium-подпиской ограничений нет.
Метод можно использовать не больше 1 раза в минуту. Соответствует разделу Аналитика → Графики в личном кабинете.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| date_from | string Дата, с которой будут данные в отчёте. Если у вас нет Premium-подписки, укажите дату в пределах последних трёх месяцев. |
| date_to | string Дата, по которую будут данные в отчёте. |
| dimension | Array of strings Группировка данных в отчёте. Способы группировки, доступные всем продавцам:
Способы группировки, доступные только продавцам с Premium-подпиской:
|
Array of objects Фильтры. | |
| limit | integer <int64> Количество значений в ответе:
|
| metrics | Array of strings Укажите до 14 метрик. Если их будет больше, вы получите ошибку с кодом Список метриĸ, по ĸоторым будет сформирован отчёт. Метрики, доступные всем продавцам:
Метрики, доступные только продавцам с Premium-подпиской:
|
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
Array of objects Настройки сортировки отчёта. |
object Результаты запроса. | |||||
| |||||
| timestamp | string Время создания отчёта. | ||||
{- "date_from": "2020-09-01",
- "date_to": "2021-10-15",
- "metrics": [
- "hits_view_search"
], - "dimension": [
- "sku",
- "day"
], - "filters": [ ],
- "sort": [
- {
- "key": "hits_view_search",
- "order": "DESC"
}
], - "limit": 1000,
- "offset": 0
}{- "result": {
- "data": [ ],
- "totals": [
- 0
]
}, - "timestamp": "2021-11-25 15:19:21"
}Метод для получения отчёта по остаткам и товарам в перемещении по складам Ozon. Соответствует разделу Аналитика → Отчёты → Отчёт по остаткам и товарам в пути на склады Ozon в личном кабинете.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| limit | integer <int64> Количество ответов на странице. По умолчанию — 100. |
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
| warehouse_type | string Default: "ALL" Enum: "ALL" "EXPRESS_DARK_STORE" "NOT_EXPRESS_DARK_STORE" Фильтр по типу склада:
|
object Результат запроса. | |||
| |||
{- "limit": 1000,
- "offset": 0,
- "warehouse_type": "ALL"
}{- "result": {
- "rows": [
- {
- "free_to_sell_amount": 0,
- "item_code": "string",
- "item_name": "string",
- "promised_amount": 0,
- "reserved_amount": 0,
- "sku": 0,
- "warehouse_name": "string",
- "idc": 0
}
]
}
}Используйте метод, чтобы узнать оборачиваемость товара и количество дней, на которое хватит текущего остатка.
Если вы запрашиваете список товаров по sku, параметры limit и offset необязательны.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| limit | integer <int32> [ 1 .. 1000 ] Количество значений в ответе. |
| offset | integer <int32> Количество элементов, которое будет пропущено в ответе. Например, если |
| sku | Array of strings <int64> Идентификаторы товаров в системе Ozon — SKU. |
Array of objects Товары. | |||||||||||||||||||
Array ()
| |||||||||||||||||||
{- "limit": 1,
- "offset": 0,
- "sku": [
- "string"
]
}{- "items": [
- {
- "ads": 0,
- "current_stock": 0,
- "idc": 0,
- "idc_grade": "GRADES_NONE",
- "name": "string",
- "offer_id": "string",
- "sku": 0,
- "turnover": 0,
- "turnover_grade": "GRADES_NONE"
}
]
}Отчёт о реализации доставленных и возвращённых товаров за месяц. Отмены и невыкупы не включаются. Соответствует разделу Финансы → Документы → Отчёты о реализации → Отчёт о реализации товара в личном кабинете.
Отчёт придёт не позднее 5-го числа следующего месяца.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| month required | integer <int32> Месяц. |
| year required | integer <int32> Год. |
object Результат запроса. | |||||
| |||||
{- "month": 0,
- "year": 0
}{- "result": {
- "header": {
- "contract_date": "string",
- "contract_number": "string",
- "currency_sys_name": "string",
- "doc_amount": 0,
- "doc_date": "string",
- "number": "string",
- "payer_inn": "string",
- "payer_kpp": "string",
- "payer_name": "string",
- "receiver_inn": "string",
- "receiver_kpp": "string",
- "receiver_name": "string",
- "start_date": "string",
- "stop_date": "string",
- "vat_amount": 0
}, - "rows": [
- {
- "commission_ratio": 0,
- "delivery_commission": {
- "amount": 0,
- "bonus": 0,
- "commission": 0,
- "compensation": 0,
- "price_per_instance": 0,
- "quantity": 0,
- "standard_fee": 0,
- "bank_coinvestment": 0,
- "stars": 0,
- "pick_up_point_coinvestment": 0,
- "total": 0
}, - "item": {
- "barcode": "string",
- "name": "string",
- "offer_id": "string",
- "sku": 0
}, - "return_commission": {
- "amount": 0,
- "bonus": 0,
- "commission": 0,
- "compensation": 0,
- "price_per_instance": 0,
- "quantity": 0,
- "standard_fee": 0,
- "bank_coinvestment": 0,
- "stars": 0,
- "pick_up_point_coinvestment": 0,
- "total": 0
}, - "rowNumber": 0,
- "seller_price_per_instance": 0
}
]
}
}Отчёт о реализации доставленных и возвращённых товаров за месяц. Отмены и невыкупы не включаются.
Отчёт придёт не позднее 5-го числа следующего месяца.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| date | string Отчётный период в формате |
Array of objects Результат запроса. | |||||
Array ()
| |||||
{- "date": "2022-09"
}{- "result": {
- "header": {
- "doc_date": "2022-09-22",
- "num": "string",
- "start_date": "2022-09-02",
- "stop_date": "2022-09-22",
- "contract_date": "2022-09-02",
- "contract_num": "string",
- "payer_name": "string",
- "payer_inn": "string",
- "payer_kpp": "string",
- "rcv_name": "string",
- "rcv_inn": "string",
- "rcv_kpp": "string",
- "doc_amount": "string",
- "vat_amount": "string",
- "currency_code": "string"
}, - "rows": [
- {
- "row_number": 0,
- "product_id": 0,
- "product_name": "string",
- "offer_id": "string",
- "barcode": "string",
- "price": 0,
- "commission_percent": 0,
- "price_sale": 0,
- "sale_qty": 0,
- "sale_amount": 0,
- "sale_discount": 0,
- "sale_commission": 0,
- "sale_price_seller": 0,
- "return_sale": 0,
- "return_qty": 0,
- "return_amount": 0,
- "return_discount": 0,
- "return_commission": 0,
- "return_price_seller": 0
}
]
}
}Возвращает подробную информацию по всем начислениям. Максимальный период, за который можно получить информацию в одном запросе — 1 месяц.
Если в запросе не указывать posting_number, то в ответе будут все отправления за указанный период или отправления определённого типа.
Соответствует разделу Финансы → Начисления в личном кабинете.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
| page | integer <int64> Номер страницы, возвращаемой в запросе. |
| page_size | integer <int64> Количество элементов на странице. |
object Результаты запроса. | |||||||
| |||||||
{- "filter": {
- "date": {
- "from": "2021-11-01T00:00:00.000Z",
- "to": "2021-11-02T00:00:00.000Z"
}, - "operation_type": [ ],
- "posting_number": "",
- "transaction_type": "all"
}, - "page": 1,
- "page_size": 1000
}{- "result": {
- "operations": [
- {
- "operation_id": 11401182187840,
- "operation_type": "MarketplaceMarketingActionCostOperation",
- "operation_date": "2021-11-01 00:00:00",
- "operation_type_name": "Услуги продвижения товаров",
- "delivery_charge": 0,
- "return_delivery_charge": 0,
- "accruals_for_sale": 0,
- "sale_commission": 0,
- "amount": -6.46,
- "type": "services",
- "posting": {
- "delivery_schema": "",
- "order_date": "",
- "posting_number": "",
- "warehouse_id": 0
}, - "items": [ ],
- "services": [ ]
}
], - "page_count": 1,
- "row_count": 355
}
}Возвращает итоговые суммы по транзакциям за указанный период. Соответствует разделу Финансы → Начисления → Баннер с общими суммами в личном кабинете.
Если вы неправильно заполните номера отправлений, в ответе вернутся нулевые значения.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по дате. | |
| posting_number | string Номер отправления. |
| transaction_type | string Тип операции:
|
object Результаты запроса. | |||||||||||||||||
| |||||||||||||||||
{- "date": {
- "from": "2021-11-01T00:00:00.000Z",
- "to": "2021-11-02T00:00:00.000Z"
}, - "posting_number": "",
- "transaction_type": "all"
}{- "result": {
- "accruals_for_sale": 96647.58,
- "sale_commission": -11456.65,
- "processing_and_delivery": -24405.68,
- "refunds_and_cancellations": -330,
- "services_amount": -1307.57,
- "compensation_amount": 0,
- "money_transfer": 0,
- "others_amount": 113.05
}
}Работая с Ozon, продавцы должны соблюдать требования по качеству обслуживания, срокам доставки и общению с клиентами. Система рейтингов отражает качество сервиса продавца, а некоторые показатели видны покупателям — это рейтинг товаров и индекс цен.
Рейтинг продавца по следующим показателям: индекс цен, доставки вовремя, процент отмен, жалобы и другие. Соответствует разделу Рейтинги → Рейтинги продавца в личном кабинете.
Array of objects Список с группами рейтингов. | |
Array of objects Данные по индексу локализации. Если за последние 14 дней у вас не было продаж, поля параметра будут пустыми. | |
| penalty_score_exceeded | boolean Признак, что баланс штрафных баллов превышен. |
| premium | boolean Признак участия в Premium-программе. |
{ }{- "groups": [
- {
- "group_name": "string",
- "items": [
- {
- "change": {
- "direction": "string",
- "meaning": "string"
}, - "current_value": 0,
- "name": "string",
- "past_value": 0,
- "rating": "string",
- "rating_direction": "string",
- "status": "string",
- "value_type": "string"
}
]
}
], - "localization_index": [
- {
- "calculation_date": "2019-08-24T14:15:22Z",
- "localization_percentage": 0
}
], - "penalty_score_exceeded": true,
- "premium": true
}Информация о рейтингах за заданный период и с фильтром по нужному рейтингу. Соответствует разделу Рейтинги → Рейтинги продавца в личном кабинете.
| date_from | string <date-time> Начало периода. |
| date_to | string <date-time> Конец периода. |
| ratings required | Array of strings Фильтр по рейтингу. Рейтинги, по которым нужно получить значение за период:
Если вы хотите получить информацию по начисленным штрафным баллам для рейтингов |
| with_premium_scores | boolean Признак, что в ответе нужно вернуть информацию о штрафных баллах в Premium-программе. |
Array of objects Информация о штрафных баллах в Premium-программе. | |
Array of objects Информация о рейтингах продавца. |
{- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "ratings": [
- "string"
], - "with_premium_scores": true
}{- "premium_scores": [
- {
- "rating": "string",
- "scores": [
- {
- "date": "2019-08-24T14:15:22Z",
- "rating_value": 0,
- "value": 0
}
]
}
], - "ratings": [
- {
- "danger_threshold": 0,
- "premium_threshold": 0,
- "rating": "string",
- "values": [
- {
- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "status": {
- "danger": true,
- "premium": true,
- "warning": true
}, - "value": 0
}
], - "warning_threshold": 0
}
]
}Бета-методы Seller API — раздел с методами, которые находятся на стадии тестирования. Такие методы могут работать нестабильно, а их запросы и ответы могут меняться. Об изменениях в работе бета-методов уведомляем за неделю в сообществе разработчиков Ozon for Dev. В сообществе вы также можете оставить обратную связь по работе бета-методов и предложить свои идеи.
Бета-методы доступны по API-ключам в зависимости от вашей роли.
Используйте метод, чтобы узнать, сколько товаров осталось на складах.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object | |
| limit | integer <int32> [ 1 .. 1000 ] Количество значений в ответе. |
| offset | integer <int32> Количество элементов, которое будет пропущено в ответе. Например, если |
Array of objects Товары. | |||||||||||||||||
Array ()
| |||||||||||||||||
{- "filter": {
- "skus": [
- "string"
], - "stock_types": "STOCK_TYPE_VALID",
- "warehouse_ids": [
- "string"
]
}, - "limit": 1,
- "offset": 0
}{- "items": [
- {
- "defect_stock_count": 0,
- "expiring_stock_count": 0,
- "name": "string",
- "offer_id": "string",
- "sku": 0,
- "valid_stock_count": 0,
- "waitingdocs_stock_count": 0,
- "warehouse_name": "string"
}
]
}Используйте метод, чтобы получить отчёт по продажам юридическим лицам. Соответствует разделу Финансы → Документы → Реестр продаж юр. лицам в личном кабинете.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| date | string Отчётный период в формате |
| language | string Default: "DEFAULT" Язык ответа:
|
object Результаты запроса. | |||
| |||
{- "date": "string",
- "language": "DEFAULT"
}{- "result": {
- "code": "string"
}
}Используйте метод, чтобы получить отчёт о взаиморасчетах. Соответствует разделу Финансы → Документы → Аналитические отчеты → Отчет о взаиморасчетах в личном кабинете.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| date | string Отчётный период в формате |
| language | string Default: "DEFAULT" Язык ответа:
|
object Результаты запроса. | |||
| |||
{- "date": "string",
- "language": "DEFAULT"
}{- "result": {
- "code": "string"
}
}Метод для получения списка всех товаров.
Если вы используете фильтр по идентификатору offer_id или product_id, остальные параметры заполнять не обязательно.
За один раз вы можете использовать только одну группу идентификаторов, не больше 1000 товаров.
Если вы не используете для отображения идентификаторы, укажите limit и last_id в следующих запросах.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по товарам. | |
| last_id | string Идентификатор последнего значения на странице. При первом запросе оставьте это поле пустым. Чтобы получить следующие значения, укажите |
| limit | integer <int64> Количество значений на странице. Минимум — 1, максимум — 1000. |
object Результат. | |||||||
| |||||||
{- "filter": {
- "offer_id": [
- "136748"
], - "product_id": [
- "223681945"
], - "visibility": "ALL"
}, - "last_id": "",
- "limit": 100
}{- "result": {
- "items": [
- {
- "archived": true,
- "has_fbo_stocks": true,
- "has_fbs_stocks": true,
- "is_discounted": true,
- "offer_id": "136748",
- "product_id": 223681945,
- "quants": [
- {
- "quant_code": "string",
- "quant_size": 0
}
]
}
], - "total": 1,
- "last_id": "bnVсbA=="
}
}Возвращает описание характеристик товаров по идентификатору и видимости. Товар можно искать по offer_id, product_id или sku.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по товарам. | |
| last_id | string Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
| limit | integer <int32> [ 1 .. 1000 ] Количество значений на странице. |
| sort_by | string Параметр, по которому товары будут отсортированы. |
| sort_dir | string Направление сортировки:
|
Array of objects Результаты запроса. | |||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||
| last_id | string Идентификатор последнего значения на странице. Чтобы получить следующие значения, укажите полученное значение в следующем запросе в параметре | ||||||||||||||||||||||||||||||||||||||
| total | string <int64> Количество товаров в списке. | ||||||||||||||||||||||||||||||||||||||
{- "filter": {
- "product_id": [
- "213761435"
], - "offer_id": [
- "testtest5"
], - "sku": [
- "123495432"
], - "visibility": "ALL"
}, - "limit": 100,
- "sort_dir": "ASC"
}{- "result": [
- {
- "id": 213761435,
- "barcode": "",
- "name": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G",
- "offer_id": "21470",
- "type_id": 124572394,
- "height": 10,
- "depth": 210,
- "width": 140,
- "dimension_unit": "mm",
- "weight": 50,
- "weight_unit": "g",
- "model_info": {
- "model_id": 43445453,
- "count": 4
}, - "pdf_list": [ ],
- "attributes": [
- {
- "id": 5219,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 970718176,
- "value": "универсальный"
}
]
}, - {
- "id": 11051,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 970736931,
- "value": "Прозрачный"
}
]
}, - {
- "id": 10100,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "false"
}
]
}, - {
- "id": 11794,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 970860783,
- "value": "safe"
}
]
}, - {
- "id": 9048,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G"
}
]
}, - {
- "id": 5076,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 39638,
- "value": "Xiaomi"
}
]
}, - {
- "id": 9024,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "21470"
}
]
}, - {
- "id": 10015,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "false"
}
]
}, - {
- "id": 85,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 971034861,
- "value": "Brand"
}
]
}, - {
- "id": 9461,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 349824787,
- "value": "Защитная пленка для смартфона"
}
]
}, - {
- "id": 4180,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G"
}
]
}, - {
- "id": 4191,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "Пленка предназначена для модели Xiaomi Redmi Note 10 Pro 5G. Защитная гидрогелевая пленка обеспечит защиту вашего смартфона от царапин, пыли, сколов и потертостей."
}
]
}, - {
- "id": 8229,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 91521,
- "value": "Защитная пленка"
}
]
}
], - "complex_attributes": [ ],
- "color_image": "",
- "description_category_id": 71107562
}
], - "total": 1,
- "last_id": "onVsfA=="
}Возвращает информацию о ĸоличестве товаров:
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
object Фильтр по товарам. | |
| limit | integer <int32> Количество значений на странице. Минимум — 1, максимум — 1000. |
| cursor | string Указатель для выборки следующих данных. |
Array of objects Информация о товарах. | |
| total | integer <int32> Количество уникальных товаров, для которых выводится информация об остатках. |
{- "cursor": "string",
- "filter": {
- "offer_id": [
- "string"
], - "product_id": [
- "string"
], - "visibility": "ALL",
- "with_quant": {
- "created": true,
- "exists": true
}
}, - "limit": 0
}{- "cursor": "string",
- "items": [
- {
- "offer_id": "string",
- "product_id": 0,
- "stocks": [
- {
- "present": 0,
- "reserved": 0,
- "shipment_type": "SHIPMENT_TYPE_GENERAL",
- "sku": 0,
- "type": "string"
}
]
}
], - "total": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| page required | integer <int64> Номер страницы. |
| page_size required | integer <int64> Количество элементов на странице. |
Array of objects Информация о сертифицируемых категориях. | |
| total | integer <int64> Всего категорий. |
{- "page": 0,
- "page_size": 0
}{- "certification": [
- {
- "category_id": 0,
- "category_name": "string",
- "is_required": true,
- "type_id": 0,
- "type_name": "string"
}
], - "total": 0
}Метод для получения информации о товарах по их идентификаторам.
В теле запроса должен быть массив однотипных идентификаторов, в ответе будет массив items.
В одном запросе вы можете передать не больше 1000 товаров по параметрам offer_id, product_id и sku в сумме.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| offer_id | Array of strings Идентификатор товара в системе продавца — артикул. |
| product_id | Array of strings <int64> Идентификатор товара. |
| sku | Array of strings <int64> Идентификатор товара в системе Ozon — SKU. |
Array of objects Массив данных. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{- "offer_id": [
- "string"
], - "product_id": [
- "string"
], - "sku": [
- "string"
]
}{- "items": [
- {
- "barcodes": [
- "string"
], - "color_image": [
- "string"
], - "commissions": [
- {
- "delivery_amount": 0,
- "percent": 0,
- "return_amount": 0,
- "sale_schema": "string",
- "value": 0
}
], - "created_at": "2019-08-24T14:15:22Z",
- "currency_code": "string",
- "description_category_id": 0,
- "discounted_fbo_stocks": 0,
- "errors": [
- {
- "attribute_id": 0,
- "code": "string",
- "field": "string",
- "level": "ERROR_LEVEL_UNSPECIFIED",
- "state": "string",
- "texts": {
- "attribute_name": "string",
- "description": "string",
- "hint_code": "string",
- "message": "string",
- "params": [
- {
- "name": "string",
- "value": "string"
}
], - "short_description": "string"
}
}
], - "has_discounted_fbo_item": true,
- "id": 0,
- "images": [
- "string"
], - "images360": [
- "string"
], - "is_archived": true,
- "is_autoarchived": true,
- "is_discounted": true,
- "is_kgt": true,
- "is_prepayment_allowed": true,
- "is_super": true,
- "marketing_price": "string",
- "min_price": "string",
- "model_info": {
- "count": 0,
- "model_id": 0
}, - "name": "string",
- "offer_id": "string",
- "old_price": "string",
- "price": "string",
- "price_indexes": {
- "color_index": "COLOR_INDEX_UNSPECIFIED",
- "external_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}, - "ozon_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}, - "self_marketplaces_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}
}, - "primary_image": [
- "string"
], - "sources": [
- {
- "created_at": "2019-08-24T14:15:22Z",
- "quant_code": "string",
- "shipment_type": "SHIPMENT_TYPE_UNSPECIFIED",
- "sku": 0,
- "source": "string"
}
], - "statuses": {
- "is_created": true,
- "moderate_status": "string",
- "status": "string",
- "status_description": "string",
- "status_failed": "string",
- "status_name": "string",
- "status_tooltip": "string",
- "status_updated_at": "2019-08-24T14:15:22Z",
- "validation_status": "string"
}, - "stocks": {
- "has_stock": true,
- "stocks": [
- {
- "present": 0,
- "reserved": 0,
- "sku": 0,
- "source": "string"
}
]
}, - "type_id": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "vat": "string",
- "visibility_details": {
- "has_price": true,
- "has_stock": true
}, - "volume_weight": 0
}
]
}Используйте метод для создания первой FBS отгрузки. В неё попадут все отправления со статусом «Готов к отгрузке». Созданная отгрузка получит статус new.
Для отгрузки в статусе new можно перезаписать состав отправлений методом /v1/carriage/set-postings. Если из отгрузки исключить часть отправлений, они могут попасть в следующую отгрузку.
Чтобы получить список отправлений в отгрузке, используйте метод /v2/posting/fbs/act/get-postings.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_method_id | integer <int64> Идентификатор метода доставки. |
| departure_date | string <date-time> Дата отгрузки. По умолчанию — текущая дата. |
| carriage_id | integer <int64> Идентификатор перевозки. |
{- "delivery_method_id": 0,
- "departure_date": "2019-08-24T14:15:22Z"
}{- "carriage_id": 0
}Используйте метод, чтобы подтвердить отгрузку после её создания. После подтверждения отгрузка перейдёт в статус «Сформирована».
После подтверждения отгрузки вы можете получить лист отгрузки методом /v2/posting/fbs/digital/act/get-pdf и штрихкод отгрузки методом /v2/posting/fbs/act/get-barcode.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| carriage_id required | integer <int64> Идентификатор отгрузки. |
| containers_count | integer <int32> Количество грузовых мест. Используйте параметр, если вы подключены к доверительной приёмке и отгружаете заказы грузовыми местами. Если вы не подключены к доверительной приёмке, пропустите его. |
{- "carriage_id": 0,
- "containers_count": 0
}{ }Используйте метод, чтобы получить список созданных отгрузок для метода доставки и их статусы.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_method_id | integer <int64> Идентификатор метода доставки. |
| departure_date | string <date-time> Дата отгрузки. По умолчанию — текущая дата. |
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{- "delivery_method_id": 0,
- "departure_date": "2019-08-24T14:15:22Z"
}{- "result": [
- {
- "assembly_list_availability": true,
- "can_create_another_carriage": true,
- "carriage_postings_count": 0,
- "carriage_quantum_count": 0,
- "carriages": [
- {
- "id": "string",
- "postings_count": 0,
- "quantum_count": 0,
- "status": "string"
}
], - "cut_in": "2019-08-24T14:15:22Z",
- "delivery_method_id": 0,
- "delivery_method_name": "string",
- "delivery_method_status": "string",
- "departure_date": "2019-08-24T14:15:22Z",
- "dropoff_address": "string",
- "dropoff_change_availability": "string",
- "dropoff_point_id": 0,
- "dropoff_point_type": "string",
- "errors": [
- {
- "code": "string",
- "description": "string",
- "status": "string"
}
], - "first_mile_changing": true,
- "first_mile_type": "string",
- "has_entrusted_acceptance": true,
- "integration_type": "string",
- "is_presort": true,
- "is_rfbs": true,
- "recommended_time_local": "string",
- "recommended_time_utc_offset_in_minutes": 0,
- "cutoff_at": "2019-08-24T14:15:22Z",
- "mandatory_packaged_count": 0,
- "mandatory_packaged_quantum_count": 0,
- "mandatory_postings_count": 0,
- "mandatory_quantum_count": 0,
- "optional_packaged_count": 0,
- "postings_for_another_carriage_count": 0,
- "quantum_for_another_carriage_count": 0,
- "timeslot_from": "2019-08-24T14:15:22Z",
- "timeslot_to": "2019-08-24T14:15:22Z",
- "tpl_provider_icon_url": "string",
- "tpl_provider_name": "string",
- "warehouse_city": "string",
- "warehouse_id": 0,
- "warehouse_name": "string"
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| carriage_id | integer <int64> Идентификатор отгрузки. |
| posting_numbers | Array of strings Актуальный список отправлений. |
Array of objects | |||||||
Array ()
| |||||||
{- "carriage_id": 0,
- "posting_numbers": [
- "string"
]
}{- "result": [
- {
- "error": "string",
- "posting_number": "string",
- "result": true
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| carriage_id | integer <int64> Идентификатор отгрузки. |
| error | string Описание ошибки. |
| carriage_status | string Статус отгрузки. |
{- "carriage_id": 0
}{- "error": "string",
- "carriage_status": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
object Фильтр по товарам. | |
| limit | integer <int32> [ 1 .. 1000 ] Количество значений на странице. |
| cursor | string Указатель для выборки следующих данных. |
Array of objects Список товаров. | |
| total | integer <int32> Количество товаров в списке. |
{- "cursor": "string",
- "filter": {
- "offer_id": [
- "356792"
], - "product_id": [
- "243686911"
], - "visibility": "ALL"
}, - "limit": 100
}{- "cursor": "string",
- "items": [
- {
- "acquiring": 0,
- "commissions": {
- "fbo_deliv_to_customer_amount": 14.75,
- "fbo_direct_flow_trans_max_amount": 46.5,
- "fbo_direct_flow_trans_min_amount": 31,
- "fbo_return_flow_amount": 50,
- "fbs_deliv_to_customer_amount": 60,
- "fbs_direct_flow_trans_max_amount": 61.5,
- "fbs_direct_flow_trans_min_amount": 41,
- "fbs_first_mile_max_amount": 25,
- "fbs_first_mile_min_amount": 0,
- "fbs_return_flow_amount": 40,
- "sales_percent_fbo": 15,
- "sales_percent_fbs": 0
}, - "marketing_actions": {
- "actions": [
- {
- "date_from": "2024-12-13T06:49:37.591Z",
- "date_to": "2024-12-13T06:49:37.591Z",
- "title": "string",
- "value": 0
}
], - "current_period_from": "2024-12-13T06:49:37.591Z",
- "current_period_to": "2024-12-13T06:49:37.591Z",
- "ozon_actions_exist": true
}, - "offer_id": "356792",
- "price": {
- "auto_action_enabled": true,
- "currency_code": "RUB",
- "marketing_price": 0,
- "marketing_seller_price": 0,
- "min_price": 0,
- "old_price": 579,
- "price": 499,
- "retail_price": 0,
- "vat": 0.2
}, - "price_indexes": {
- "color_index": "WITHOUT_INDEX",
- "external_index_data": {
- "min_price": 0,
- "min_price_currency": "string",
- "price_index_value": 0
}, - "ozon_index_data": {
- "min_price": 0,
- "min_price_currency": "string",
- "price_index_value": 0
}, - "self_marketplaces_index_data": {
- "min_price": 0,
- "min_price_currency": "string",
- "price_index_value": 0
}
}, - "product_id": 243686911,
- "volume_weight": 0
}
], - "total": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| product_ids | Array of strings <int64> Список идентификаторов товаров. |
{- "product_ids": [
- "string"
]
}{ }Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| product_ids | Array of strings <int64> Список идентификаторов товаров. |
Array of objects | |||||||
Array ()
| |||||||
{- "product_ids": [
- "string"
]
}{- "statuses": [
- {
- "expired_at": "2019-08-24T14:15:22Z",
- "min_price_for_auto_actions_enabled": true,
- "product_id": 0
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| cluster_ids | Array of strings <int64> Идентификаторы кластеров. |
| cluster_type required | string Enum: "CLUSTER_TYPE_OZON" "CLUSTER_TYPE_CIS" Тип кластера:
|
Array of objects Кластеры. | |||||||||
Array ()
| |||||||||
{- "cluster_ids": [
- "string"
], - "cluster_type": "CLUSTER_TYPE_OZON"
}{- "clusters": [
- {
- "id": 0,
- "logistic_clusters": [
- {
- "is_archived": true,
- "warehouses": [
- {
- "name": "string",
- "type": "FULL_FILLMENT",
- "warehouse_id": 0
}
]
}
], - "name": "string",
- "type": "CLUSTER_TYPE_OZON"
}
]
}Используйте метод, чтобы найти сортировочное центры, пункты выдачи или приёма заказов, доступные для кросс-докинга и прямых поставок.
Вы можете посмотреть адреса всех точек на карте и в виде таблицы в Базе знаний.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| filter_by_supply_type required | Array of strings Items Enum: "CREATE_TYPE_CROSSDOCK" "CREATE_TYPE_DIRECT" Тип поставки:
|
| search required | string >= 4 characters Поиск по названию склада. Для поиска пунктов выдачи заказов укажите полное название. |
Array of objects Результат поиска складов. | |||||||||||
Array ()
| |||||||||||
{- "filter_by_supply_type": [
- "CREATE_TYPE_CROSSDOCK"
], - "search": "string"
}{- "search": [
- {
- "address": "string",
- "coordinates": {
- "latitude": 0,
- "longitude": 0
}, - "name": "string",
- "warehouse_id": 0,
- "warehouse_type": "WAREHOUSE_TYPE_DELIVERY_POINT"
}
]
}Создать черновик заявки на поставку — прямой или кросс-докинг, а также указать поставляемые товары.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| cluster_ids | Array of strings <int64> Идентификаторы кластеров. |
| drop_off_point_warehouse_id | integer <int64> Идентификатор точки отгрузки — пункта выдачи заказов или сортировочного центра.
Только для типа поставки |
required | Array of objects <= 5000 items Товары. |
| type required | string Enum: "CREATE_TYPE_CROSSDOCK" "CREATE_TYPE_DIRECT" Тип поставки:
|
| operation_id | string Идентификатор черновика заявки на поставку. |
{- "cluster_ids": [
- "string"
], - "drop_off_point_warehouse_id": 0,
- "items": [
- {
- "quantity": 0,
- "sku": 0
}
], - "type": "CREATE_TYPE_CROSSDOCK"
}{- "operation_id": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| operation_id required | string Идентификатор черновика заявки на поставку. |
Array of objects Кластеры. | |
| draft_id | integer <int64> Идентификатор черновика заявки на поставку. |
Array of objects Ошибки. | |
| status | string Default: "CALCULATION_STATUS_FAILED" Enum: "CALCULATION_STATUS_FAILED" "CALCULATION_STATUS_SUCCESS" "CALCULATION_STATUS_IN_PROGRESS" "CALCULATION_STATUS_EXPIRED" Статус создания черновика заявки на поставку:
|
{- "operation_id": "string"
}{- "clusters": [
- {
- "cluster_id": 0,
- "cluster_name": "string",
- "warehouses": [
- {
- "address": "string",
- "bundle_ids": [
- {
- "bundle_id": "string",
- "is_docless": true
}
], - "name": "string",
- "restricted_bundle_id": "string",
- "status": {
- "invalid_reason": "WAREHOUSE_SCORING_INVALID_REASON_UNSPECIFIED",
- "is_available": true,
- "state": "WAREHOUSE_SCORING_STATUS_FULL_AVAILABLE"
}, - "supply_warehouse": {
- "address": "string",
- "name": "string",
- "warehouse_id": 0
}, - "total_rank": 0,
- "total_score": 0,
- "travel_time_days": 0,
- "warehouse_id": 0
}
]
}
], - "draft_id": 0,
- "errors": [
- {
- "error_message": "string",
- "items_validation": [
- {
- "reasons": [
- "string"
], - "sku": 0
}
], - "unknown_cluster_ids": [
- "string"
]
}
], - "status": "CALCULATION_STATUS_FAILED"
}Доступные таймслоты на конечных складах отгрузки.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| date_from required | string <date-time> Дата начала нужного периода доступных таймслотов. |
| date_to required | string <date-time> Дата окончания нужного периода доступных таймслотов. Максимальный период — 28 дней с текущей даты. |
| draft_id required | integer <int64> Идентификатор черновика заявки на поставку. |
| warehouse_ids required | Array of strings <int64> <= 10 items Идентификаторы складов, для которых нужно получить таймслоты. |
Array of objects Таймслоты складов. | |
| requested_date_from | string <date-time> Дата начала интересующего периода. |
| requested_date_to | string <date-time> Дата окончания интересующего периода. |
{- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "draft_id": 0,
- "warehouse_ids": [
- "string"
]
}{- "drop_off_warehouse_timeslots": [
- {
- "current_time_in_timezone": "2019-08-24T14:15:22Z",
- "days": [
- {
- "date_in_timezone": "2019-08-24T14:15:22Z",
- "timeslots": [
- {
- "from_in_timezone": "2019-08-24T14:15:22Z",
- "to_in_timezone": "2019-08-24T14:15:22Z"
}
]
}
], - "drop_off_warehouse_id": 0,
- "warehouse_timezone": "string"
}
], - "requested_date_from": "2019-08-24T14:15:22Z",
- "requested_date_to": "2019-08-24T14:15:22Z"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| draft_id required | integer <int64> Идентификатор черновика заявки на поставку. |
object Таймслот поставки. | |
| warehouse_id required | integer <int64> Идентификатор склада отгрузки. |
| operation_id | string Идентификатор заявки на поставку. |
{- "draft_id": 0,
- "timeslot": {
- "from_in_timezone": "2019-08-24T14:15:22Z",
- "to_in_timezone": "2019-08-24T14:15:22Z"
}, - "warehouse_id": 0
}{- "operation_id": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| operation_id required | string Идентификатор заявки на поставку. |
| error_messages | Array of strings Ошибки создания заявок. | ||
object Идентификаторы заявок на поставку. | |||
| |||
| status | string Default: "DraftSupplyCreateStatusUnknown" Enum: "DraftSupplyCreateStatusUnknown" "DraftSupplyCreateStatusSuccess" "DraftSupplyCreateStatusFailed" "DraftSupplyCreateStatusInProgress" Статус создания заявки на поставку:
| ||
{- "operation_id": "string"
}{- "error_messages": [
- "string"
], - "result": {
- "order_ids": [
- "string"
]
}, - "status": "DraftSupplyCreateStatusUnknown"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
| limit | integer <int64> Максимальное количество элементов в ответе. |
| visibility | string Default: "ALL" Enum: "ALL" "VISIBLE" "INVISIBLE" "EMPTY_STOCK" "NOT_MODERATED" "MODERATED" "DISABLED" "STATE_FAILED" "READY_TO_SUPPLY" "VALIDATION_STATE_PENDING" "VALIDATION_STATE_FAIL" "VALIDATION_STATE_SUCCESS" "TO_SUPPLY" "IN_SALE" "REMOVED_FROM_SALE" "OVERPRICED" "CRITICALLY_OVERPRICED" "EMPTY_BARCODE" "BARCODE_EXISTS" "QUARANTINE" "ARCHIVED" "OVERPRICED_WITH_STOCK" "PARTIAL_APPROVED" Фильтр по видимости товара:
|
| cursor | string Указатель для выборки следующих данных. |
Array of objects Эконом-товары. | |
| total_items | integer <int32> Остаток на всех складах, шт. |
{- "cursor": "string",
- "limit": 0,
- "visibility": "ALL"
}{- "cursor": "string",
- "products": [
- {
- "offer_id": "string",
- "product_id": 0,
- "quants": [
- {
- "quant_code": "string",
- "quant_size": 0
}
]
}
], - "total_items": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| quant_code required | Array of strings [ 1 .. 1000 ] items Список квантов с товарами. |
Array of objects Эконом-товары. | |||||||
Array ()
| |||||||
{- "quant_code": [
- "string"
]
}{- "items": [
- {
- "offer_id": "string",
- "product_id": 0,
- "quant_info": {
- "quants": [
- {
- "barcodes_extended": [
- {
- "barcode": "string",
- "error": "string",
- "status": "string"
}
], - "dimensions": {
- "depth": 0,
- "height": 0,
- "weight": 0,
- "width": 0
}, - "marketing_price": {
- "price": "string",
- "seller_price": "string"
}, - "min_price": "string",
- "old_price": "string",
- "price": "string",
- "quant_code": "string",
- "quant_sice": 0,
- "shipment_type": "string",
- "sku": 0,
- "statuses": {
- "state_description": "string",
- "state_name": "string",
- "state_sys_name": "string",
- "state_tooltip": "string"
}
}
]
}
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
object Фильтр. | |
| limit | integer <int32> <= 1000 Максимальное количество значений в ответе. |
| sort | string Параметр, по которому товары будут отсортированы. |
| sort_dir | string Направление сортировки:
|
object Список квантов. | |||||||
| |||||||
{- "cursor": "string",
- "filter": {
- "created_at": {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}, - "cutoff": {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}, - "destination_place_id": 0,
- "inv_quant_ids": [
- "string"
], - "offer_id": "string",
- "sku_name": "string",
- "statuses": [
- "unknown"
], - "warehouse_id": 0
}, - "limit": 0,
- "sort": "string",
- "sort_dir": "string"
}{- "result": {
- "cursor": "string",
- "has_next": true,
- "quants": [
- {
- "available_actions": [
- "string"
], - "awaiting_stock_due_date": "2019-08-24T14:15:22Z",
- "cancel_reason": {
- "cancel_reason_id": 0,
- "cancel_reason_name": "string",
- "responsible": "string"
}, - "company_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "current_postings_count": 0,
- "cutoff": "2019-08-24T14:15:22Z",
- "delivery_method_name": "string",
- "destination_place_id": 0,
- "destination_place_name": "string",
- "filling_percent": 0,
- "first_posting_cancellation_date": "2019-08-24T14:15:22Z",
- "id": 0,
- "inv_quant_id": 0,
- "last_status_change_at": "2019-08-24T14:15:22Z",
- "offer_id": "string",
- "products_price": 0,
- "quantum_start_date": "2019-08-24T14:15:22Z",
- "sku": 0,
- "sku_name": "string",
- "status": "unknown",
- "target_postings_count": 0,
- "tpl_provider_name": "string",
- "type": "string",
- "warehouse_id": 0,
- "warehouse_name": "string"
}
]
}
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| inv_quant_id required | integer <int64> Инвентарный идентификатор кванта. |
Array of objects Информация о кванте. | |||||||||||||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||||||||||||
{- "inv_quant_id": 0
}{- "result": [
- {
- "available_actions": [
- "string"
], - "awaiting_stock_due_date": "2019-08-24T14:15:22Z",
- "cancel_reason": {
- "cancel_reason_id": 0,
- "cancel_reason_name": "string",
- "responsible": "string"
}, - "current_postings_count": 0,
- "cutoff": "2019-08-24T14:15:22Z",
- "delivery_method_name": "string",
- "destination_place_id": 0,
- "destination_place_name": "string",
- "filling_percent": 0,
- "first_posting_cancellation_date": "2019-08-24T14:15:22Z",
- "id": 0,
- "inv_quant_id": 0,
- "offer_id": "string",
- "postings": [
- {
- "cancel_reason": {
- "cancel_reason_id": 0,
- "cancel_reason_name": "string",
- "responsible": "string"
}, - "posting_number": "string",
- "products_price": 0,
- "status_alias": "string",
- "status_id": 0
}
], - "product_picture_url": "string",
- "products_price": 0,
- "quantum_start_date": "2019-08-24T14:15:22Z",
- "sku": 0,
- "sku_name": "string",
- "status": "unknown",
- "target_postings_count": 0,
- "tpl_provider_name": "string",
- "type": "string",
- "warehouse_id": 0,
- "warehouse_name": "string"
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| inv_quant_id required | integer <int64> Инвентарный идентификатор кванта. |
{- "inv_quant_id": 0
}{ }Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| inv_quant_id required | integer <int64> Инвентарный идентификатор кванта. |
| status | string Default: "unknown" Enum: "unknown" "new" "filling" "fulled" "reserving" "awaiting_stock" "awaiting_packaging" "shipped" "awaiting_delivery" "delivering" "delivered" "not_accepted" "failed" "ship_in_process" "ship_failed" "quant_in_carriage" "acceptance_in_progress" "cancelled" Статус:
|
{- "inv_quant_id": 0
}{- "status": "unknown"
}Используйте метод, чтобы передать грузоместа и товарный состав в заявку на поставку.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | Array of objects Информация о грузоместах. Вы можете передать не больше 40 палет или 30 коробок. |
| delete_current_version | boolean
|
| supply_id required | integer <int64> Идентификатор поставки. |
| operation_id | string Идентификатор операции. |
object Ошибки. |
{- "cargoes": [
- {
- "key": "string",
- "value": {
- "items": [
- {
- "barcode": "string",
- "expires_at": "2019-08-24T14:15:22Z",
- "quant": 0,
- "quantity": 0
}
], - "type": "BOX"
}
}
], - "delete_current_version": true,
- "supply_id": 0
}{- "operation_id": "string",
- "errors": {
- "error_reasons": [
- "INVALID_STATE"
], - "items_validation": [
- {
- "barcode": "string",
- "cargo_key": "string",
- "quant": 0,
- "type": "SUPPLY_ITEM_NOT_FOUND"
}
]
}
}Используйте метод, чтобы получить информацию по установленным грузоместам.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| operation_id required | string Идентификатор операции. |
object Результат запроса. | |||
| |||
| status | string Default: "SUCCESS" Enum: "SUCCESS" "IN_PROGRESS" "FAILED" Статус формирования грузомест:
| ||
object Ошибки. | |||
{- "operation_id": "string"
}{- "result": {
- "cargoes": [
- {
- "key": "string",
- "value": {
- "cargo_id": 0
}
}
]
}, - "status": "SUCCESS",
- "errors": {
- "error_reasons": [
- "INVALID_STATE"
], - "items_validation": [
- {
- "barcode": "string",
- "cargo_key": "string",
- "quant": 0,
- "type": "SUPPLY_ITEM_NOT_FOUND"
}
]
}
}Используйте метод, чтобы сгенерировать этикетки для грузомест из заявки на поставку.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Информация о грузоместах. | |
| supply_id required | integer <int64> Идентификатор поставки. |
| operation_id | string Идентификатор операции. |
object Ошибки. |
{- "cargoes": [
- {
- "cargo_id": 0
}
], - "supply_id": 0
}{- "operation_id": "string",
- "errors": {
- "error_reasons": [
- "INVALID_STATE"
]
}
}Используйте метод, чтобы получить статус формирования этикеток и идентификатор файла с ними.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| operation_id required | string Идентификатор операции. |
object Информация об этикетках. | |||
| |||
| status | string Default: "SUCCESS" Enum: "SUCCESS" "IN_PROGRESS" "FAILED" Статус формирования этикеток:
| ||
object Ошибки. | |||
{- "operation_id": "string"
}{- "result": {
- "file_guid": "string"
}, - "status": "SUCCESS",
- "errors": {
- "error_reasons": [
- "INVALID_STATE"
]
}
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}Доступно только для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| mark_review_as_processed | boolean Обновление статуса у отзыва:
|
| parent_comment_id | string Идентификатор родительского комментария, на который вы отвечаете. |
| review_id required | string Идентификатор отзыва. |
| text required | string Текст комментария. |
| comment_id | string Идентификатор комментария. |
{- "mark_review_as_processed": true,
- "parent_comment_id": "string",
- "review_id": "string",
- "text": "string"
}{- "comment_id": "string"
}Доступно только для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| comment_id required | string Идентификатор комментария. |
{- "comment_id": "string"
}{ }Доступно только для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
Метод возвращает информацию по комментариям на отзывы, которые прошли модерацию.
| limit required | integer <int32> Ограничение значений в ответе. Минимум — 20. Максимум — 100. |
| offset | integer <int32> Количество элементов, которое будет пропущено с начала списка в ответе. Например, если |
| review_id required | string Идентификатор отзыва. |
| sort_dir | string Default: "ASC" Enum: "ASC" "DESC" Направление сортировки:
|
Array of objects Информация о комментарии. | |
| offset | integer <int32> Количество элементов в выдаче. |
{- "limit": 0,
- "offset": 0,
- "review_id": "string",
- "sort_dir": "ASC"
}{- "comments": [
- {
- "id": "string",
- "is_official": true,
- "is_owner": true,
- "parent_comment_id": "string",
- "published_at": "2019-08-24T14:15:22Z",
- "text": "string"
}
], - "offset": 0
}Доступно только для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| review_ids required | Array of strings Массив с идентификаторами отзывов от 1 до 100. |
| status required | string Статус отзыва:
|
{- "review_ids": [
- "string"
], - "status": "string"
}{ }Доступно только для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| processed | integer <int32> Количество обработанных отзывов. |
| total | integer <int32> Количество всех отзывов. |
| unprocessed | integer <int32> Количество необработанных отзывов. |
{ }{- "processed": 0,
- "total": 0,
- "unprocessed": 0
}Доступно только для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| review_id required | string Идентификатор отзыва. |
| comments_amount | integer <int32> Количество комментариев к отзыву. |
| dislikes_amount | integer <int32> Количество дизлайков на отзыве. |
| id | string Идентификатор отзыва. |
| is_rating_participant | boolean
|
| likes_amount | integer <int32> Количество лайков на отзыве. |
| order_status | string Статус заказа, на который покупатель оставил отзыв:
|
Array of objects Информация об изображении. | |
| photos_amount | integer <int32> Количество изображений у отзыва. |
| published_at | string <date-time> Дата публикации отзыва. |
| rating | integer <int32> Оценка отзыва. |
| sku | integer <int64> Идентификатор товара в системе Ozon — SKU. |
| status | string Статус отзыва:
|
| text | string Текст отзыва. |
Array of objects Информация о видео. | |
| videos_amount | integer <int32> Количество видео у отзыва. |
{- "review_id": "string"
}{- "comments_amount": 0,
- "dislikes_amount": 0,
- "id": "string",
- "is_rating_participant": true,
- "likes_amount": 0,
- "order_status": "string",
- "photos": [
- {
- "height": 0,
- "url": "string",
- "width": 0
}
], - "photos_amount": 0,
- "published_at": "2019-08-24T14:15:22Z",
- "rating": 0,
- "sku": 0,
- "status": "string",
- "text": "string",
- "videos": [
- {
- "height": 0,
- "preview_url": "string",
- "short_video_preview_url": "string",
- "url": "string",
- "width": 0
}
], - "videos_amount": 0
}Доступно только для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
Метод не возвращает параметры «Достоинства» и «Недостатки», если они есть в отзывах на товар. Эти параметры устарели, в новых отзывах их нет.
| last_id | string Идентификатор последнего отзыва на странице. |
| limit required | integer <int32> Количество отзывов в ответе. Минимум — 20, максимум — 100. |
| sort_dir | string Направление сортировки:
|
| status | string Статусы отзывов:
|
| has_next | boolean
|
| last_id | string Идентификатор последнего отзыва на странице. |
Array of objects Информация об отзыве. |
{- "last_id": "string",
- "limit": 0,
- "sort_dir": "string",
- "status": "string"
}{- "has_next": true,
- "last_id": "string",
- "reviews": [
- {
- "comments_amount": 0,
- "id": "string",
- "is_rating_participant": true,
- "order_status": "string",
- "photos_amount": 0,
- "published_at": "2019-08-24T14:15:22Z",
- "rating": 0,
- "sku": 0,
- "status": "string",
- "text": "string",
- "videos_amount": 0
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| question_id required | string Идентификатор вопроса. |
| sku required | int64 SKU товара. |
| text required | string Текст ответа объёмом от 2 до 3000 символов. |
| answer_id | string Идентификатор ответа на вопрос. |
{- "question_id": "0192a009-769f-7ee9-b412-893045171a66",
- "sku": 646399170,
- "text": "текст"
}{- "answer_id": "0192e7ce-e12c-7a74-afc7-26e877799204"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| answer_id required | string Идентификатор ответа. |
| sku required | int64 SKU товара. |
Ответ удалён
{- "answer_id": "0192e7ce-e12c-7a74-afc7-26e877799204",
- "sku": 646399170
}{ }Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| last_id | Идентификатор последнего значения на странице. Если запрос первый, оставьте поле пустым. Для следующих значений указывайте |
| question_id required | string Идентификатор вопроса. |
| sku required | int64 SKU товара. |
Array of objects Ответы. | |
| last_id | string Идентификатор последнего значения на странице. Чтобы получить следующие значения, передайте полученное значение в следующем запросе в параметре |
{- "last_id": "string",
- "question_id": "019228a7-91d8-76af-a73a-e989dfac7ac8",
- "sku": 646399170
}{- "answers": [
- {
- "author_name": "string",
- "id": "string",
- "published_at": "2024-08-14T11:44:35.352Z",
- "question_id": "string",
- "sku": 646399170,
- "text": "string"
}
], - "last_id": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| question_ids required | Array of strings Идентификаторы вопросов. |
| status required | string Статусы вопросов:
|
Статус изменён.
{- "question_ids": [
- "string"
], - "status": "VIEWED"
}{ }Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| all | int64 Всего вопросов. |
| new | int64 Новые вопросы. |
| processed | int64 Обработанные вопросы. |
| unprocessed | int64 Необработанные вопросы. |
| viewed | int64 Просмотренные вопросы. |
{- "all": 10,
- "new": 3,
- "processed": 4,
- "unprocessed": 1,
- "viewed": 1
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| question_id required | string Идентификатор вопроса |
| answers_count | int64 Количество ответов на вопрос. |
| author_name | string Автор вопроса. |
| id | string Идентификатор вопроса. |
| product_url | string Ссылка на товар. |
| published_at | timestamp Дата публикации вопроса. |
| question_link | string Ссылка на вопрос. |
| sku | int64 SKU товара. |
| status | enum Статус вопроса:
|
| text | string Текст вопроса. |
{- "question_id": "string"
}{- "answers_count": "0",
- "author_name": "Пользователь OZON",
- "sku": 646399170,
- "id": "0192a009-769f-7ee9-b412-893045171a66",
- "text": "Я отказываюсь от твоего отказа!",
- "published_at": "2024-10-08T10:09:29.099284Z",
- "status": "VIEWED"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
| last_id | string Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
Array of objects Вопросы. | |
| last_id | string Идентификатор последнего значения на странице. Чтобы получить следующие значения, передайте полученное значение в следующем запросе в параметре |
{- "filter": {
- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "status": "string"
}, - "last_id": "string"
}{- "questions": [
- {
- "answers_count": 1,
- "author_name": "Пользователь OZON",
- "id": "019294ff-6888-7009-89d8-26569e4e450d",
- "sku": 646399170,
- "published_at": "2024-08-14T12:02:01.889Z",
- "text": "Новый вопрос о товаре Света",
- "status": "PROCESSED"
}
], - "last_id": "019228a7-91d8-76af-a73a-e989dfac7ac8"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| limit required | int64 Количество значений в ответе: максимум — 100, минимум — 1. |
| sku | Array of strings <int64> Список SKU товаров. |
{- "limit": "100"
}{- "sku": [
- 56371271
]
}| Ошибка | Описание |
|---|---|
Circle is open |
Если выполняется большое количество запросов, система блокирует работу метода. В течение нескольких минут метод начнет работать как обычно. |
Internal error |
Сервер не успел обработать запрос. |
| Ошибка | Описание |
|---|---|
GTD_MUST_BE_SPECIFIED_FOR_PRODUCT_COUNTRY |
Не указан номер ГТД. Если ГТД нет, передайте is_gtd_absent: true. |
| Ошибка | Описание |
|---|---|
Fatal error: You have more than 1 FBS warehouses. Please use API Method POST /v2/products/stocks |
У вас несколько складов и вы обновляете остатки методом /v1/product/import/stocks. Обновите остатки методом /v2/products/stocks. |
product_is_not_created |
Товар не прошёл модерацию, поэтому обновить остатки пока нельзя. Дождитесь статуса price_sent и попробуйте ещё раз. |
offer_id_not_found |
Товара с таким артикулом нет в личном кабинете. |
FLAMMABLE_ONLY_ON_SELF_OR_PROVIDER_DELIVERY |
Легковоспламеняющиеся товары можно продавать только со своего склада с доставкой самостоятельно или сторонней службой. Выберите другой склад или создайте новый и попробуйте ещё раз. |
WAREHOUSE_NOT_FOUND |
Склад warehouse_id не найден. Проверьте наличие ошибок в ID склада и его статус — он должен быть активный. |
PRODUCT_HAS_NOT_BEEN_TAGGED_YET |
Товар ещё не пометили тегами «КГТ» или «неКГТ», так как не указаны габариты товара или система для расстановки тегов ещё не обработала его. |
NON_KGT_ON_KGT_WAREHOUSE |
Попытка установить или обновить остаток некрупногабаритного товара на КГТ складе. |
PRICE_IS_NOT_SENT |
Товар ещё не создан или находится на стадии обновления. |
MP_DELIVERY_ONLY_3PL_ERROR |
Товар нельзя размещать на складе с методом доставки «Ozon логистика». |
TOO_MANY_REQUESTS |
Вы слишком часто обновляли остатки для одного артикула. Остатки для одного артикула можно обновлять не чаще одного раза в 2 минуты. |
MULTIBOX_NOT_ALLOWED_FOR_FBS |
При работе по схеме FBS нельзя объединить товары из нескольких коробок в один товар. Удалите значение из поля stock и повторите попытку. |
OVER_MAX_OVH_NON_KGT |
Через выбранный склад нельзя продавать крупногабаритные товары. Выберите другой склад или создайте новый и повторите попытку. |
OVER_MAX_OVH_KGT |
Вес или габариты товара превышают максимальные значения для выбранного склада. Измените характеристики товара или выберите другой склад. |
SOURCE_TYPE_NOT_FOUND |
У товара нет SKU. Проверьте, что товар создан и правильно настроен. |
Request validation error: invalid ProductsStocksRequest.Stocks[0]: embedded message failed validation |
В запросе не указан идентификатор склада. Его можно узнать с помощью метода /v1/warehouse/list. |
STOCK_TOO_BIG |
Вы указали слишком большое значение для остатка товара. Укажите количество меньше миллиона и повторите запрос. |
FLAMMABLE_ON_NON_KGT_WAREHOUSE |
Легковоспламеняемые товары можно продавать только со склада для крупногабаритных товаров. Выберите другой склад или создайте новый. |
NOT_FOUND_ERROR |
Товар не найден в личном кабинете. |
| Ошибка | Описание |
|---|---|
MAX_OFFSET_EXCEEDED |
Вы превысили лимит количества элементов в запросе. Убедитесь, что значение в поле offset не больше 20000. |
| Ошибка | Описание |
|---|---|
TRANSITION_IS_NOT_POSSIBLE |
Вы передали некорректный порядок статусов заказов rFBS. |
HAS_INCORRECT_TPL_INTEGRATION_TYPE |
Попытка передать статус на заказ rFBS при доставке интегрированной службой доставки. |
POSTING_NOT_FOUND |
Заказа нет в личном кабинете партнёра. |
POSTING_ALREADY_CANCELLED |
Заказ уже отменён. |
POSTING_ALREADY_SHIPPED |
Заказ уже собран. |
HAS_INCORRECT_STATUS |
У заказа некорректный статус. |
HAS_INCORRECT_PRODUCT_QUANTITY |
Неправильное количество продуктов или неправильный SKU в запросе. |
UNKNOWN_PRODUCT_DEFINED |
Указан неверный идентификатор товара. Проверьте, что в поле product_id вы указали SKU товара. |
EXEMPLAR_INFO_ALREADY_DEFINED |
Информация об экземплярах товара уже обновлена. Передавать данные повторно не нужно. |
MANDATORY_MARK_REDUNDANT |
Для товара не нужно передавать код маркировки. |
EXEMPLAR_INFO_NOT_FILLED_COMPLETELY |
Убедитесь, что вы передали всю информацию по экземплярам товаров в заказе. |
| Ошибка | Описание |
|---|---|
The next postings aren't ready |
Товар ещё не готов к печати маркировки. |
INVALID_ARGUMENT |
Печать этикетки возможна только для заказов со статусом «Ожидает отгрузки» — awaiting_deliver. Проверьте, что у отправления верный статус. |
NO_POSTINGS_FOR_BATCH_DOWNLOAD |
В запросе нет заказов со статусом «Ожидает отгрузки». |
| Ошибка | Описание |
|---|---|
can't create carriage |
Перевозка ещё не готова к созданию. Добавьте акты на отгрузку. |
Company has no FBS-warehouses |
У вас нет созданного склада FBS. |
DELIVERY_METHOD_NOT_FOUND |
Вы передали некорректный идентификатор метода доставки — delivery_method_id. |
first_mile_absent |
Для метода доставки не указан способ отгрузки. Подробнее о настройке склада |
first_mile_is_changing |
Обновляются настройки склада. Отгрузка станет доступна после обновления. |
has_overflow |
Пункт перегружен. Выберите другой, чтобы сроки доставки не увеличивались. |
has_postings_with_registration_error |
Часть отправлений не может попасть в акт из-за ошибки регистрации в сервисе доставки. |
has_seller_returns_in_stock |
Заберите возвраты. |
has_surge |
Пункт приёма переполнен и стоимость отгрузки временно увеличена. Для экономии выберите менее загруженный пункт. |
Invalid Api-Key, please contact support |
Проверьте корректность используемого токена для API-ключа и вызываемого метода. |
new_postings_are_possible |
В отгрузку ещё могут попасть новые отправления. Используйте метод, когда закончится сегодняшнее время на сборку заказов. |
no_postings |
Для выбранного метода нет доступных отправлений. |
non_carriageable |
Отгрузка не требуется. |
not_accepted_on_sc |
Обработайте отправления на вкладке Спорные в личном кабинете. Чтобы добавить оправление в уже созданную отгрузку, отмените предыдущую и создайте новую. |
not_packaged |
У вас есть отправления, которые нужно передать в доставку сегодня — добавьте их в отгрузку. |
not_registered |
Регистрируем отправления в сервисе доставки. Сформируйте акт, когда все отправления получат статус awaiting_deliver — готов к отгрузке. |
other |
Возникла ошибка. Обратитесь за помощью в поддержку. |
outdated |
Указана прошедшая дата. |
package_time_not_passed |
Время для формирования отгрузки ещё не наступило. |
partial_carriage_formed |
Все частичные перевозки созданы. |
partial_carriage_in_proccess |
Создайте ещё несколько частичных перевозок. |
posting_statuses_not_ready |
Формируем отгрузку. Повторите запрос через несколько минут. |
there_are_incomplete_carriages |
Есть незавершённые перевозки. |
Trying set ContainersCount to not HasEntrustedAcceptance company |
Чтобы передать количество грузовых мест, подключитесь к доверительной приёмке. Подробнее о доверительной приёмке |
will_be_partial_carriage |
Создайте несколько частичных перевозок. |
Incorrect_carriage_status |
Перевозка ещё не сформировалась. Акт должен быть в статусе sended или formed. Чтобы получить статус, используйте метод /v2/posting/fbs/act/list. |
| Ошибка | Описание |
|---|---|
invalid_cat egory_price |
Попытка установить слишком высокую или слишком низкую цену на товар. |
discount_for_average_price_is_too_small |
Слишком маленькая скидка. Если цена после скидки от 400 до 10 000 рублей включительно, разница между ценами до и после скидки должна быть больше 5%. |
discount_for_low_price_is_too_small |
Слишком маленькая скидка. Если цена после скидки ниже 400 рублей включительно, разница между ценами до и после скидки должна быть больше 20 рублей. |
discount_too_big |
Слишком большая скидка. Разница между ценами до и после скидки должна быть менее 90%. |
discount_for_top_price_is_too_small |
Слишком маленькая скидка. Если цена после скидки выше 10 000 рублей, разница между ценами до и после скидки должна быть больше 500 рублей. |
price_negative |
Попытка установить отрицательную цену. |
NOT_FOUND_ERROR |
Товара с таким идентификатором нет в личном кабинете. |
| Ошибка | Описание |
|---|---|
SPU_already_exists |
Товар с такими характеристиками уже существует. |
"Invalid_state" - Product is not ready to supply |
Товар не готов к обновлению остатков. Возможно, товар не создан или аккаунт не активирован. |
Incorrect_density |
Товар не прошёл проверку на плотность. Указанная вами плотность находится вне допустимого диапазона. Минимальное значение плотности — 0,001, максимальное — 13,55. Плотность рассчитывается по формуле: вес × 1000 ÷ (высота × ширина × глубина). Также проверьте, что вы используете корректные значения массы и объёма для вашего товара. |
| Ошибка | Описание |
|---|---|
result: items: 0 |
Убедитесь, что указана корректная категория товара и проставлен НДС . |
| Ошибка | Описание |
|---|---|
HAS_INCORRECT_CANCEL_REASON |
Указан неправильный идентификатор отмены заказа. |
| Ошибка | Описание |
|---|---|
GTD_IS_REQUIRED_ONLY_FOR_LEGAL_CUSTOMER |
Грузовую таможенную декларацию должны передавать только юридическим лицам. |
EXEMPLAR_ID does not belong to product PRODUCT_ID |
Идентификатор экземпляра exemplar_id не соответствует идентификатору товара product_id. Получите корректный exemplar_id методом /v5/fbs/posting/product/exemplar/create-or-get. |
В разделе описано, как подключить пуш-уведомления, чтобы получать от Ozon на свой сервис информацию о событиях:
Также можно получать информацию о сообщениях и уведомлениях, которые не были доставлены из-за недоступности вашего сервиса.
Отключить уведомления можно в разделе Настройки → Интеграции на вкладке Push уведомления.
| Ошибка | Описание | Решение |
|---|---|---|
| REQUEST_ERROR | Запрос не отправлен, нет подключения по указанному адресу. | Проверьте, что ваш сервис работает. |
| REQUEST_TIMEOUT | Превышено время ожидания запроса. | Увеличьте время ожидания запроса. |
| SERVER_FAULT | Ваш сервис вернул внутреннюю ошибку сервера. | Изучите логи сервера, обновите серверное ПО, увеличьте выделенные ресурсы или обратитесь к администратору сервера. |
| STATUS_CODE_NOT_OK | HTTP-статус ответа сервиса не равен 200. | Проверьте передаваемый код статуса. |
| EMPTY_BODY | Тело ответа пустое или отсутствует. | Проверьте, что ответ на сервере сформирован правильно, и, что данные корректно передаются. |
| INVALID_BODY | Некорректный формат тела ответа. | Проверьте формат ответа и убедитесь, что заголовок Content-Type равен application/json. |
| INVALID_JSON | Ошибка при разборе или валидации JSON-данных. | Проверьте правильность JSON-данных и исправьте ошибки в синтаксисе. |
| WRONG_RESULT_FIELD | Ваш сервис вернул тело ответа не по шаблону. | Проверьте, что формат ответа соответствует шаблону. Подробнее о шаблоне |
| WRONG_RESULT_TIME_FIELD | Некорректное поле time в теле ответа. |
Проверьте формат времени в ответе. |
{
"message_type": "string",
"time": "2019-08-24T14:15:22Z"
}
Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_PING. |
time |
string | date-time | Дата и время отправки уведомления в формате UTC. |
При успешной обработке уведомления сервис должен вернуть ответ с кодом HTTP 200:
{
"version": "string",
"name": "string",
"time": "2019-08-24T14:15:22Z"
}
Параметр |
Тип | Формат | Описание |
|---|---|---|---|
version |
string | — | Версия приложения. |
name |
string | — | Название приложения. |
time |
string | date-time | Дата и время начала обработки уведомления в формате UTC. |
При ошибке во время обработки уведомления сервис должен вернуть ответ с кодом HTTP из групп 4xx или 5xx:
{
"error": {
"code": "ERROR_UNKNOWN",
"message": "ошибка",
"details": null
}
}
Параметр |
Тип | Формат | Описание |
|---|---|---|---|
error |
object | — | Информация об ошибке. |
code |
string | — | Код ошибки: • ERROR_UNKNOWN — неизвестная ошибка.• ERROR_PARAMETER_VALUE_MISSED — не указано значение одного или нескольких параметров.• ERROR_REQUEST_DUPLICATED — дублирующийся запрос. |
message |
string | — | Детальное описание ошибки. |
details |
string | — | Дополнительная информация. |
Если уведомление не доставлено, через несколько секунд система попытается отправить запрос ещё несколько раз. Интервал между попытками будет постепенно увеличиваться. Когда он достигнет максимального значения в 10 минут, будет ещё 5 попыток каждые 10 минут.
Если сообщение по-прежнему не получится доставить, попытки отправки запроса прекратятся.
Если ваш сервис недоступен или возвращает ошибки в течение 24 часов, отправка всех уведомлений будет приостановлена. Чтобы возобновить их получение, в личном кабинете продавца повторно подтвердите URL-адрес сервиса.
Для каждого из типов уведомлений Ozon отправляет REST-запросы на адрес вашего сервиса. Ваш сервис должен отвечать по стандартам REST API.
| Тип | Назначение |
|---|---|
| TYPE_PING | Проверка статуса готовности сервиса при первичном подключении и периодически после подключения |
| TYPE_NEW_POSTING | Новое отправление |
| TYPE_POSTING_CANCELLED | Отмена отправления |
| TYPE_STATE_CHANGED | Изменение статуса отправления |
| TYPE_CUTOFF_DATE_CHANGED | Изменение даты отгрузки отправления |
| TYPE_DELIVERY_DATE_CHANGED | Изменение даты доставки отправления |
| TYPE_CREATE_OR_UPDATE_ITEM | Создание и обновление товара или ошибка в процессе |
| TYPE_CREATE_ITEM | Создание товара или ошибка при его создании |
| TYPE_UPDATE_ITEM | Обновление товара или ошибка при обновлении |
| TYPE_PRICE_INDEX_CHANGED | Изменение ценового индекса товара |
| TYPE_STOCKS_CHANGED | Изменение остатков на складах продавца |
| TYPE_NEW_MESSAGE | Новое сообщение в чате |
| TYPE_UPDATE_MESSAGE | Изменение сообщения в чате |
| TYPE_MESSAGE_READ | Ваше сообщение прочитано покупателем или поддержкой |
| TYPE_CHAT_CLOSED | Чат закрыт |
Уведомления приходят только для FBS и rFBS отправлений:
{
"message_type": "TYPE_NEW_POSTING",
"posting_number": "24219509-0020-1",
"products": [
{
"sku": 147451959,
"quantity": 2
}
],
"in_process_at": "2021-01-26T06:56:36.294Z",
"warehouse_id": 18850503335000,
"seller_id": 15
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_NEW_POSTING. |
posting_number |
string | — | Номер отправления. |
products |
array | — | Информация о товарах. |
sku |
integer | int64 | SKU товара. |
quantity |
integer | int64 | Количество товара. |
in_process_at |
string | date-time | Дата и время начала обработки отправления в формате UTC. |
warehouse_id |
integer | int64 | Идентификатор склада, на котором хранятся товары для этого отправления. |
seller_id |
integer | int64 | Идентификатор продавца. |
Уведомления приходят только для FBS и rFBS отправлений:
{
"message_type": "TYPE_POSTING_CANCELLED",
"posting_number": "24219509-0020-1",
"products": [
{
"sku": 147451959,
"quantity": 1
}
],
"old_state": "posting_transferred_to_courier_service",
"new_state": "posting_canceled",
"changed_state_date": "2021-01-26T06:56:36.294Z",
"reason": {
"id": 0,
"message": "string"
},
"warehouse_id": 0,
"seller_id": 15
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_POSTING_CANCELLED. |
posting_number |
string | — | Номер отправления. |
products |
array | — | Информация о товарах. |
sku |
integer | int64 | SKU товара. |
quantity |
integer | int64 | Количество товара. |
old_state |
string | — | Предыдущий статус отправления. |
new_state |
string | — | Новый статус отправления: posting_canceled — отменено. |
changed_state_date |
string | date-time | Дата и время изменения статуса отправления в формате UTC. |
reason |
object | — | Информация о причине отмены. |
id |
integer | int64 | Идентификатор причины отмены. |
message |
string | — | Причина отмены. |
warehouse_id |
integer | int64 | Идентификатор склада, на котором хранятся товары для этого отправления. |
seller_id |
integer | int64 | Идентификатор продавца. |
posting_acceptance_in_progress — идёт приёмка,posting_created — создано,posting_transferring_to_delivery — передаётся в доставку,posting_in_carriage — в перевозке,posting_not_in_carriage — не добавлен в перевозку,posting_in_client_arbitration — клиентский арбитраж доставки,posting_on_way_to_city — на пути в город,posting_transferred_to_courier_service — передаётся курьеру,posting_in_courier_service — курьер в пути,posting_on_way_to_pickup_point — на пути в пункт выдачи,posting_in_pickup_point — в пункте выдачи,posting_conditionally_delivered — условно доставлено,posting_driver_pick_up — у водителя,posting_not_in_sort_center — не принят на сортировочном центре.Соответствие статусных моделей Seller API и статусов пуш-модели.
| Seller API | Push-модель | ||
|---|---|---|---|
| Статус | Описание | Статус | Описание |
acceptance_in_progress |
Идёт приёмка. | posting_acceptance_in_progress |
Идёт приёмка. |
awaiting_approve |
Ожидает подтверждения. | posting_created |
Создана. |
awaiting_packaging |
Ожидает упаковки. | posting_created |
Создана. |
awaiting_registration |
Ожидает регистрации. | posting_awaiting_registration |
Ожидает регистрации. |
awaiting_deliver |
Ожидает отгрузки. | posting_transferring_to_delivery |
Передаётся в доставку. |
posting_in_carriage |
В перевозке. | ||
posting_not_in_carriage |
Не добавлен в перевозку. | ||
arbitration |
Арбитраж. | posting_in_arbitration |
Арбитраж. |
client_arbitration |
Клиентский арбитраж доставки. | posting_in_client_arbitration |
Клиентский арбитраж. |
delivering |
Доставляется. | posting_on_way_to_city |
На пути в ваш город. |
posting_transferred_to_courier_service |
Передаётся курьеру. | ||
posting_in_courier_service |
Курьер в пути. | ||
posting_on_way_to_pickup_point |
На пути в пункт выдачи. | ||
posting_in_pickup_point |
В пункте выдачи. | ||
posting_conditionally_delivered |
Условно доставлено. | ||
driver_pickup |
У водителя. | posting_driver_pick_up |
У водителя. |
delivered |
Доставлено. | posting_delivered |
Доставлено. |
posting_received |
Получено. | ||
cancelled |
Отменено. | posting_canceled |
Отменено. |
not_accepted |
Не принято на сортировочном центре. | posting_not_in_sort_center |
Не принято на сортировочном центре. |
Уведомления приходят только для FBS и rFBS отправлений.
{
"message_type": "TYPE_STATE_CHANGED",
"posting_number": "24219509-0020-2",
"new_state": "posting_delivered",
"changed_state_date": "2021-02-02T15:07:46.765Z",
"warehouse_id": 0,
"seller_id": 15
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_STATE_CHANGED. |
posting_number |
string | — | Номер отправления. |
new_state |
string | — | Новый статус отправления. |
changed_state_date |
string | date-time | Дата и время изменения статуса отправления в формате UTC. |
warehouse_id |
integer | int64 | Идентификатор склада, на котором хранятся товары для этого отправления. |
seller_id |
integer | int64 | Идентификатор продавца. |
posting_acceptance_in_progress — идёт приёмка,posting_transferring_to_delivery — передаётся в доставку,posting_in_carriage — в перевозке,posting_not_in_carriage — не добавлен в перевозку,posting_in_arbitration — арбитраж,posting_in_client_arbitration — клиентский арбитраж доставки,posting_on_way_to_city — на пути в город,posting_transferred_to_courier_service — передаётся курьеру,posting_in_courier_service — курьер в пути,posting_on_way_to_pickup_point — на пути в пункт выдачи,posting_in_pickup_point — в пункте выдачи,posting_conditionally_delivered — условно доставлено,posting_driver_pick_up — у водителя,posting_delivered — доставлено,posting_not_in_sort_center — не принят на сортировочном центре.Уведомления приходят только для FBS и rFBS отправлений:
{
"message_type": "TYPE_CUTOFF_DATE_CHANGED",
"posting_number": "24219509-0020-2",
"new_cutoff_date": "2021-11-24T07:00:00Z",
"old_cutoff_date": "2021-11-21T10:00:00Z",
"warehouse_id": 0,
"seller_id": 15
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_CUTOFF_DATE_CHANGED. |
posting_number |
string | — | Номер отправления. |
new_cutoff_date |
string | date-time | Новые дата и время отгрузки в формате UTC. |
old_cutoff_date |
string | date-time | Предыдущие дата и время отгрузки в формате UTC. |
warehouse_id |
integer | int64 | Идентификатор склада, на котором хранятся товары для этого отправления. |
seller_id |
integer | int64 | Идентификатор продавца. |
Уведомление, которое отправляет Ozon:
{
"message_type": "TYPE_DELIVERY_DATE_CHANGED",
"posting_number": "24219509-0020-2",
"new_delivery_date_begin": "2021-11-24T07:00:00Z",
"new_delivery_date_end": "2021-11-24T16:00:00Z",
"old_delivery_date_begin": "2021-11-21T10:00:00Z",
"old_delivery_date_end": "2021-11-21T19:00:00Z",
"warehouse_id": 0,
"seller_id": 15
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_DELIVERY_DATE_CHANGED. |
posting_number |
string | — | Номер отправления. |
new_delivery_date_begin |
string | date-time | Новые дата и время начала доставки в формате UTC. |
new_delivery_date_end |
string | date-time | Новые дата и время окончания доставки в формате UTC. |
old_delivery_date_begin |
string | date-time | Предыдущие дата и время начала доставки в формате UTC. |
old_delivery_date_end |
string | date-time | Предыдущие дата и время окончания доставки в формате UTC. |
warehouse_id |
integer | int64 | Идентификатор склада, на котором хранятся товары для этого отправления. |
seller_id |
integer | int64 | Идентификатор продавца. |
Уведомление, которое отправляет Ozon:
{
"message_type": "TYPE_CREATE_OR_UPDATE_ITEM",
"seller_id": 0,
"offer_id": "string",
"product_id": 0,
"is_error": false,
"changed_at": "2022-09-01T14:15:22Z"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
seller_id |
integer | int64 | Идентификатор продавца. |
message_type |
string | — | Тип уведомления — TYPE_CREATE_OR_UPDATE_ITEM. |
offer_id |
string | — | Артикул товара. |
product_id |
integer | int64 | Идентификатор товара. |
is_error |
boolean | — | Признак, что при создании или обновлении товара возникли ошибки: • true — были ошибки, товар не создан или не обновлён;• false — товар создан или обновлён без ошибок. |
changed_at |
string | date-time | Дата и время изменения. |
Уведомление, которое отправляет Ozon:
{
"message_type": "TYPE_CREATE_ITEM",
"seller_id": 0,
"offer_id": "string",
"product_id": 0,
"is_error": false,
"changed_at": "2021-09-01T14:15:22Z"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
seller_id |
integer | int64 | Идентификатор продавца. |
message_type |
string | — | Тип уведомления — TYPE_CREATE_ITEM. |
offer_id |
string | — | Артикул товара. |
product_id |
integer | int64 | Идентификатор товара. |
is_error |
boolean | — | Признак, что при создании товара возникли ошибки: • true — были ошибки, товар не создан;• false — товар создан без ошибок. |
changed_at |
string | date-time | Дата и время изменения. |
Уведомление, которое отправляет Ozon:
{
"message_type": "TYPE_UPDATE_ITEM",
"seller_id": 0,
"offer_id": "string",
"product_id": 0,
"is_error": false,
"changed_at": "2021-09-01T14:15:22Z"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
seller_id |
integer | int64 | Идентификатор продавца. |
message_type |
string | — | Тип уведомления — TYPE_UPDATE_ITEM. |
offer_id |
string | — | Артикул товара. |
product_id |
integer | int64 | Идентификатор товара. |
is_error |
boolean | — | Признак, что при обновлении товара возникли ошибки: • true — были ошибки, товар не создан;• false — товар создан без ошибок. |
changed_at |
string | date-time | Дата и время изменения. |
Уведомление, которое отправляет Ozon:
{
"seller_id": 0,
"message_type": "string",
"updated_at":"2022-06-21T05:52:46.648533678Z",
"sku": 0,
"product_id": 0,
"price_index": 0
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
seller_id |
integer | int64 | Идентификатор продавца. |
message_type |
string | — | Тип уведомления — TYPE_PRICE_INDEX_CHANGED. |
updated_at |
string | date-time | Дата и время изменения ценового индекса. |
sku |
integer | int64 | SKU товара. |
product_id |
integer | int64 | Идентификатор товара. |
price_index |
integer | int64 | Ценовой индекс. |
Уведомление, которое отправляет Ozon:
{
"message_type": "string",
"seller_id": 0,
"items": [
{
"product_id": 0,
"sku": 0,
"updated_at": "2021-09-01T14:15:22Z",
"stocks": [
{
"warehouse_id": 0,
"present": 0,
"reserved": 0
}
]
}
]
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
seller_id |
integer | int64 | Идентификатор продавца. |
message_type |
string | — | Тип уведомления — TYPE_STOCKS_CHANGED. |
items |
array | — | Массив с данными товаров. |
updated_at |
string | date-time | Дата и время изменения. |
sku |
integer | int64 | SKU товара при работе по схемам FBS или rFBS. |
product_id |
integer | int64 | Идентификатор товара. |
stocks |
array | — | Массив с данными по остаткам товара. |
warehouse_id |
integer | int64 | Идентификатор склада. |
present |
integer | int64 | Общее количество товара на складе. |
reserved |
integer | int64 | Количество зарезервированных товаров на складе. |
{
"message_type": "TYPE_NEW_MESSAGE",
"chat_id": "b646d975-0c9c-4872-9f41-8b1e57181063",
"chat_type": "Buyer_Seller",
"message_id": "3000000000817031942",
"created_at": "2022-07-18T20:58:04.528Z",
"user": {
"id": "115568",
"type": "Сustomer"
},
"data": [
"Текст сообщения"
],
"seller_id": "7"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_NEW_MESSAGE. |
chat_id |
string | — | Идентификатор чата. |
chat_type |
string | — | Тип чата: • Seller_Support — чат с поддержкой.• Buyer_Seller — чат с покупателем.• Seller_Notification — уведомления Ozon. |
message_id |
string | — | Идентификатор сообщения. |
created_at |
string | date-time | Дата создания сообщения. |
user |
object | — | Информация об отправителе сообщения. |
id |
string | — | Идентификатор отправителя. |
type |
string | — | Тип отправителя: • Customer — покупатель.• Support — поддержка.• NotificationUser — Ozon. |
data |
array of string | — | Массив с содержимым сообщения в формате Markdown. |
seller_id |
integer | int64 | Идентификатор продавца. |
{
"message_type": "TYPE_UPDATE_MESSAGE",
"chat_id": "b646d975-0c9c-4872-9f41-8b1e57181063",
"chat_type": "Buyer_Seller",
"message_id": "3000000000817031942",
"created_at": "2022-07-18T20:58:04.528Z",
"updated_at": "2022-07-18T20:59:04.528Z",
"user": {
"id": "115568",
"type": "Сustomer"
},
"data": [
"Текст сообщения"
],
"seller_id": "7"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_UPDATE_MESSAGE. |
chat_id |
string | — | Идентификатор чата. |
chat_type |
string | — | Тип чата: • Seller_Support — чат с поддержкой.• Buyer_Seller — чат с покупателем.• Seller_Notification — уведомления Ozon. |
message_id |
string | — | Идентификатор сообщения. |
created_at |
string | date-time | Дата создания сообщения. |
updated_at |
string | date-time | Дата изменения сообщения. |
user |
object | — | Информация об отправителе сообщения. |
id |
string | — | Идентификатор отправителя. |
type |
string | — | Тип отправителя: • Customer — покупатель.• Support — поддержка.• NotificationUser — Ozon. |
data |
array of string | — | Массив с содержимым сообщения в формате Markdown. |
seller_id |
integer | int64 | Идентификатор продавца. |
{
"message_type": "TYPE_MESSAGE_READ",
"chat_id": "b646d975-0c9c-4872-9f41-8b1e57181063",
"chat_type": "Buyer_Seller",
"message_id": "3000000000817031942",
"created_at": "2022-07-18T20:58:04.528Z",
"user": {
"id": "115568",
"type": "Сustomer"
},
"last_read_message_id": "3000000000817031942",
"seller_id": "7"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_MESSAGE_READ. |
chat_id |
string | — | Идентификатор чата. |
chat_type |
string | — | Тип чата: • Seller_Support — чат с поддержкой.• Buyer_Seller — чат с покупателем.• Seller_Notification — уведомления Ozon. |
message_id |
string | — | Идентификатор сообщения. |
created_at |
string | date-time | Дата создания сообщения. |
user |
object | — | Информация о пользователе, прочитавшем сообщение. |
id |
string | — | Идентификатор пользователя. |
type |
string | — | Тип пользователя: • Customer — покупатель.• Support — поддержка.• NotificationUser — Ozon. |
last_read_message_id |
string | — | Идентификатор последнего прочитанного сообщения. |
seller_id |
integer | int64 | Идентификатор продавца. |
{
"message_type": "TYPE_CHAT_CLOSED",
"chat_id": "b646d975-0c9c-4872-9f41-8b1e57181063",
"chat_type": "Buyer_Seller",
"user": {
"id": "115568",
"type": "Сustomer"
},
"seller_id": "7"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_CHAT_CLOSED. |
chat_id |
string | — | Идентификатор чата. |
chat_type |
string | — | Тип чата: • Seller_Support — чат с поддержкой.• Buyer_Seller — чат с покупателем.• Seller_Notification — уведомления Ozon. |
user |
object | — | Информация о пользователе, закрывшем чат. |
id |
string | — | Идентификатор пользователя. |
type |
string | — | Тип пользователя: • Customer — покупатель.• Support — поддержка.• NotificationUser — Ozon. |
seller_id |
integer | int64 | Идентификатор продавца. |
При успешной обработке уведомления сервис должен вернуть ответ с кодом HTTP 200:
{
"result": true
}
Параметр |
Тип | Формат | Описание |
|---|---|---|---|
result |
boolean | — | Уведомление получено. |
При ошибке во время обработки уведомления сервис должен вернуть ответ с кодом HTTP из групп 4xx или 5xx:
{
"error": {
"code": "ERROR_UNKNOWN",
"message": "ошибка",
"details": null
}
}
Параметр |
Тип | Формат | Описание |
|---|---|---|---|
error |
object | — | Информация об ошибке. |
code |
string | — | Код ошибки: • ERROR_UNKNOWN — неизвестная ошибка.• ERROR_PARAMETER_VALUE_MISSED — не указано значение одного или нескольких параметров.• ERROR_REQUEST_DUPLICATED — дублирующийся запрос. |
message |
string | — | Детальное описание ошибки. |
details |
string | — | Дополнительная информация. |